본문으로 건너뛰기

로컬로 연동된 텔레그램 봇만으로 점심 추천 앱 만들고 Vercel배포까지

로컬로 연동된 텔레그램 봇만으로 점심 추천 앱 만들고 Vercel배포까지 본문 이미지

작성일: 2026-06-01
이전 글: 로컬 속도 56 t/s까지 올리고, 텔레그램에서 계산기 만들기까지


📝 한줄 요약

Hermes + Qwen3.5-9B 텔레그램 봇(로컬유성이)만으로 Google My Maps KML 147곳 → 점심 추천 웹앱 → GitHub → Vercel까지 갔다. 로컬 localhost에선 됐는데 배포 후 404 → JSON fetch 실패 → name: "" → Maps 이름 검색 오류가 연쇄로 터졌고, 원인은 Git에 JSON 누락·fetch 파일명 불일치·CSV BOM/콤마·좌표 링크 미적용이었다. 정적 HTML + JSON 경로 문제였다.


처음에는 "로컬 모델로 계산기 앱을 만들었으니 다른 앱도 금방이겠지?"라는 가벼운 호기심에서 출발했습니다. 그래서 난이도를 한 단계 높여, 단순한 계산기를 넘어 Vercel 배포까지 포함된 실질적인 웹 애플리케이션 개발에 도전하게 되었습니다.

이번 프로젝트를 진행하게 된 배경과 구체적인 목표는 다음과 같습니다.

💡 개발 배경 및 동기

  • 신입사원들의 고충 해결 (핵심 동기): 회사 문화상 신입사원들이 매일 점심 메뉴를 정해야 하는 일종의 '업무'가 있었고, 매번 메뉴 선정으로 스트레스를 받는 동료들을 보며 실질적인 도움을 주고 싶었습니다.

  • 개인 데이터의 활용: 평소 회사 근처 식당 리스트를 구글 맵에 저장하고, 개인적인 별점과 평가를 꾸준히 기록해둔 데이터가 있었습니다.

  • 기존 앱의 재구성: 과거에 신입사원들의 고충해결인 메뉴 고르기가 힘들 때 이 데이터를 활용하여 Cursor로 '점심 추천 앱'을 만들어 사용했던 경험이 있습니다. 그래서 과거에 만든 앱이 탄생하였고 같은 구조로 실험하게 되었습니다.

  • 스터디 과제 적용: 현재 참여 중인 스터디 과제의 일환으로, 기존 작업을 한 단계 디벨롭하고 이를 비용이 들지 않는 안정적인 로컬 AI 환경으로 전환하는 사례를 만들고자 했습니다.

🎯 이번 사례로 확인하고자 하는 3가지

  1. 결과물 퀄리티 비교 과거 Cursor를 활용해 만들었던 애플리케이션과, 이번에 오직 로컬 모델만으로 작성한 애플리케이션의 전반적인 완성도와 퀄리티 차이를 비교해 봅니다.

  2. 로컬 모델의 한계 및 성능 테스트 비교적 가벼운 모델인 Qwen 3.5 9B 로컬 모델이 실제 애플리케이션 기획 및 개발 과정에서 어디까지 역할을 수행할 수 있는지 그 한계를 테스트합니다.

  3. 실제 배포 가능성 검증 정말로 파라미터가 낮은 로컬 모델의 코딩 능력만으로도, 오류 없이 애플리케이션을 완성하고 Vercel에 배포까지 완결성 있게 진행할 수 있는지 확인합니다.

전날 텔레그램에서 HTML 계산기 file tool까지 성공했습니다. 이번엔 IDE 없이 폰 채팅만으로 실서비스를 만들어 보기로 했어요.

점심메뉴 추천 어플리케이션
1. 버튼 → 자동 추천
2. 팝업 → 식당명, 별점, 후기, 구글 지도 링크
3. 링크 클릭 → 웹에서 Maps 열림
백데이터: Google My Maps KML → CSV
Vanilla JS + GitHub → Vercel
KML: https://www.google.com/maps/d/u/0/kml?mid=1qaZ1y5gcGBOHem5GPC0rO0UcUK_Q&forcekml=1

결론부터: 앱 기능 구현은 텔레그램만으로 가능했지만, 배포·데이터 파이프라인에서 Phase 5~7이 Phase 3보다 더 길었습니다.


1. 사용한 모델과 환경

항목

내용

PC

RTX 3070, i7-12700K, RAM 32GB, Windows 11

모델

Qwen3.5-9B Q3_K_M (qwen/qwen3.5-9b)

실행

LM Studio (http://127.0.0.1:1234/v1)

에이전트

Hermes AI Agent (Gateway)

인터페이스

Telegram만 — 봇 이름 로컬유성이

KML

삼성역 근처 맛집 및 정보 지도.kml (Downloads·첨부)

GitHub

kims5306/samseong-restaurants

Vercel

samseong-restaurants.vercel.app

로컬 테스트

http://localhost:8080/samseong-restaurants.html


2. 목표 vs 중간 산출물

#

처음 기획

중간에 만들어진 것

최종

UI

추천 버튼 + 팝업 + Maps

kml-viewer/ (검색·페이지네이션)

samseong-restaurants.html

데이터

KML → CSV → fetch

sample 5곳 / 빈 CSV

147 Placemark

Maps

링크 클릭

이름 검색 URL

좌표(lat,lng) URL

배포

GitHub + Vercel

localhost만

push + vercel.app

교훈: 봇이 "완성!"이라고 해도 목표 UI와 다른 중간물이 나올 수 있다. 기획 3줄을 다시 붙여넣는 게 Phase 전환의 트리거였습니다.


3. Phase 1~2 — tool call·compression·404

3-1. 코드는 채팅에, 파일은 디스크에 없음 : 아니 파이썬 파일도 작성해 줘야지;; 툴 콜링을 스스로 못하다니....

✍️ write_file...
⚠ Stream stalled mid tool-call (write_file); the action was not executed.

3-2. /stop 후 CSV 147곳 성공 (잠깐)

파이썬으로 지도 링크를 접근 한 후 삼성역 근처 맛집 및 정보 지도.kml 선택 → Folder 안 Placemark + Point 파싱 수정:

✅ Placemark 147개, kml_data_export.csv

곧바로 범용 kml-viewer 3파일 생성 — 추천 버튼·팝업 없음.

3-5. compression → 기억 상실 : 컨택스트 길이에 따른 휘발성으로 인한....

🗜️ Context too large (~29,293 tokens) — compressing...
🗜️ Compressed 59 → 8 messages
CSV 없음 / kml_to_csv.py 없음  ← 방금 한 작업 전부 잊음


4. Phase 3 — KML 첨부 → 목표 앱 완성

4-1. .kml은 py로 코딩된 파일로 읽기

드디어 파이썬으로 링크에 접근하고 파일 다운로드 한 위치에서 kml파일을 읽기시작
.kml files aren't directly supported by the file reading tools

4-2. CSV→JSON 30분 대기 후 samseong-restaurants.html 생성

⏳ iteration 3/90 — 30 min, 1000s no chunks
✅ samseong-restaurants.html
🎲 랜덤 추천 / ⭐ 최고 평점 / 모달 / Maps 링크
http://localhost:8080/samseong-restaurants.html

147 Placemark — 부타이 1막, 교대밀밭 삼성점, 옐로 트렁크 등 (description에 ★★★★).

Phase 3 = 처음 기획 3가지 전부 로컬에서 구현.


5. Phase 4 — GitHub push & Vercel

JSON write_file → git add
gh CLI 없음 → GitHub UI 수동 안내
사용자: https://github.com/xxxxxx/samseong-restaurants 알아서 push해
✅ GitHub push 성공 (봇 보고)

npm install -g vercel
vercel login → 인터랙티브 타임아웃 → Vercel 웹 UI Import

배포 URL: https://samseong-restaurants.vercel.app/


6. Phase 5 — 배포 직후: 404 & JSON 지옥

6-1. 증상

앱에서 JSON 하드코딩 같고 CSV/JSON 로드 안 됨
404: NOT_FOUND (icn1::p57ld-...)
JSON Git에 없음 — HTML만 push됨

6-2. fetch 경로 꼬임

HTML이 fetch하는 이름

repo 실제 파일

samseong-restaurants.json

(없음)

삼성역 근처 맛집 및 정보 지도_export.json

(다름)

—

_export_export.json → later _export.json

6-3. Gemini 404 분석 vs 실제 : 이름을 못가져오는 사유 발생

Gemini: Python serverless, vercel.json rewrites, FastAPI, 텔레그램 polling.

api/main.py

❌ 정적 HTML

rewrites → Python

△ vercel.json 추가했으나 루트 index.html·JSON 경로가 핵심

실제 원인

JSON Git 미포함 + fetch 404 + name: ""


7. Phase 6 — name: "" 빈 필드

7-1. 사용자 확인

삼성역 근처 맛집 및 정보 지도_export.json — name 여전히 공란

7-2. 원인 3가지 (봇이 최종적으로 찾은 것)

① UTF-8 BOM

# csv.DictReader가 BOM 때문에 첫 컬럼명을 '\ufeffname'으로 읽음
# → row['name']은 항상 빈값

② description 안의 콤마

"★★★★ 일식 돈카츠, 마제소바(...)"
→ quote 처리 없으면 열이 밀림

③ 파일명 이중 저장 suffix

_export_export.json  →  _export.json

7-3. 해결 (스크립트)

# BOM 제거
open(path, encoding='utf-8-sig')

# 콤마 in description
csv.DictReader(f, quotechar='"')

# 결과 확인
"name": "부타이 1막"
"name": "교대밀밭 삼성점"
Git 충돌 → pull → push
✅ 최종 JSON push (봇 보고)

그런데 Vercel 앱에서는 여전히 이름 안 나옴 → Phase 7.


8. Phase 7 — 앱에서 이름·Maps 링크 수정

8-1. 사용자 피드백

1. 어플리케이션상 식당 이름 안 나온다
2. 링크는 좌표 기반이어야 하는데 엉뚱한 곳 검색됨

8-2. 원인

문제 1 — fetch 경로 (또)

// ❌ 배포 HTML
fetch('삼성역 근처 맛집 및 정보 지도_export.json')

// ✅ 수정
fetch('_export.json')   // 또는 restaurants.json 으로 rename 권장

문제 2 — Maps URL : 좌표를 통한 검색이 아닌 이름+서울로 검색되는 오류 발생

// ❌ 이름 검색 — 동명이인·오검색
`https://www.google.com/maps/search/?api=1&query=${name + ', 서울'}`

// ✅ 좌표 직접 이동
`https://www.google.com/maps/search/?api=1&query=${latitude},${longitude}`
// 또는: https://www.google.com/maps?q=37.5061858,127.0600424

8-3. 수정 후

🔧 patch HTML (fetch + Maps 좌표)
git pull → push
→ Vercel Redeploy 안내

대화 마지막 시점: HTML·JSON 수정 push 완료(봇 보고), Vercel Redeploy는 사용자 PC에서 진행 필요.



9. Phase별 한눈에

Phase

핵심

성공?

1~2

tool stall, compression, kml-viewer

❌

3

KML 147 + 추천 HTML

✅ 로컬

4

GitHub + Vercel URL

✅ 연결

5

404, JSON Git, fetch

⚠️

6

name BOM/콤마

✅ JSON

7

fetch + Maps 좌표

✅ push, Redeploy 대기


10. 배포 체크리스트 (최종본)

[x] KML → CSV 147곳 (Downloads 실제 파일)
[x] 점심 추천 HTML (랜덤·모달·Maps)
[x] GitHub xxxxxx/samseong-restaurants
[x] Vercel 프로젝트 연결
[x] JSON name 필드 (BOM utf-8-sig, quotechar)
[x] HTML fetch('_export.json') 또는 restaurants.json
[x] Maps URL 좌표 기반
[ ] index.html — Vercel 루트(/) 404 방지용 rename
[ ] Vercel Redeploy 후 curl로 JSON 200 확인
[ ] vercel.app에서 부타이 1막 표시 + Maps 좌표 확인

권장 repo 구조

samseong-restaurants/
├── index.html              # samseong-restaurants.html rename
├── restaurants.json        # name·lat·lng 포함, utf-8-sig 없음
├── vercel.json             # (선택) 정적 설정
└── README.md

배포 후 검증

# JSON 200 + name 필드
curl https://samseong-restaurants.vercel.app/restaurants.json | Select-String "부타이"

# 로컬과 동일 동작
cd app-folder
python -m http.server 8080
# 브라우저 → 랜덤 추천 → 모달 이름 → Maps 좌표

11. 함정 총정리

함정

증상

대응

Stream stalled

write_file 미실행

/stop, 재시도

Command Approval

python -c 멈춤

.py 파일 실행

compression

59→8, 193→179 messages

/new, memory 저장

목표 drift

kml-viewer

기획 3줄 재붙여넣기

HTML만 git push

Vercel 404

JSON 같이 commit

fetch 파일명

JSON 404

repo 파일명 = HTML fetch

CSV BOM

"name": ""

encoding='utf-8-sig'

description 콤마

열 밀림

quotechar='"'

Maps 이름 검색

엉뚱한 위치

lat,lng URL

vercel login

타임아웃

웹 UI Import

gh CLI 없음

repo create

URL 주면 git remote push

Gemini serverless

irrelevant

정적 HTML+JSON 관점

텔레그램 필수 명령 : 코딩으로 인한 컨택스트 길이 문제때문에 사용했습니다.

명령

용도

/stop

iteration·Approval 중단

/reset / /new

세션·tool 히스토리 초기화

기획 3줄 재전송

Phase 복귀


12. 배포한 사이트 실행 확인 : https://samseong-restaurants.vercel.app/

  1. 메인화면

  2. 랜덤추천을 눌렀을 경우

    한국어 검색 페이지 스크린샷
  3. 구글 지도로 이동을 눌렀을 때

    한국의 어느 도시의 위치를 ​​보여주는 지도

13. 과거 배포한 어플리케이션 확인 : https://lunch-red.vercel.app/

  1. 메인화면

    한국어 텍스트가 적힌 보라색 화면
  2. 메뉴추천을 눌렀을 경우

    한국어 신청서 스크린샷
  3. 링크를 눌렀을 경우 지도이동

    한국의 레스토랑 위치를 보여주는 지도

14. 두개의 바이브코딩으로 만든 작품의 비교

항목

과거 cursor작품

현재 로컬 LLM작품

차이원인

사용모델

cursor + Claude 3.5 Sonnet

hermes + qwen3.5 9b

과거작은 2년전 완성.

랜덤추천버튼

있음

있음

둘다 프롬프트는 추천버튼을 만들어달라고 함.

지도

구글 map 좌표이용

구글 map 좌표로 네이버 또는 구글 주소 컨버전

컨버전이 DB자료양이 많아 컨텍스트를 많이먹어 로컬은 하지않음.

15. 마무리 결론 !!

  1. hermes + Qwen 3.5 텔레그램봇만으로 앱 만들기는 가능합니다. — KML 147곳, HTML, git push까지 Qwen3.5-9B + Hermes tool call로 갔습니다. 퀄리티가 엄청 좋다는 아니지만 꽤 쓸만한 형태까지 나오는것으로 보입니다. 과거 2년전 만든 앱과 비교했을때 퀄리티는 다소 떨어집니다만 이정도면 쓸만하다고 생각합니다.

  2. 로컬 OK ≠ Vercel OK — localhost:8080과 vercel.app 사이에 Git tracking·fetch 경로·Redeploy 3단계가 있습니다.

  3. 가장 긴 구간은 코딩이 아니라 데이터입니다. — Phase 6~7의 BOM·콤마·파일명·fetch·Maps 좌표. 로컬의 컨텍스트 길이안에 데이터의 크기가 들어오기가 참 어렵습니다.

  4. "name": ""은 모델 문제가 아니라 CSV 파싱 — UTF-8 BOM + description 내 콤마. JSON 열어보면 5초 만에 의심 가능.

  5. Maps는 이름 검색 말고 좌표 — KML에 lat/lng가 있으니 query=37.xx,127.xx가 정확합니다.

  6. 봇 "완성!"은 3번 확인 — (1) Explorer/JSON (2) localhost (3) curl 배포 URL.

  7. compression은 배포 디버깅의 적 — 193 messages 압축 후 fetch 경로를 또 틀리게 patch.

  8. 스킬 자동 생성 — kml-csv-conversion-and-web-app-deployment → kml-csv-json-conversion-and-web-app-deployment.

  9. 최종 한 줄 — 텔레그램 봇은 90% 코딩, 10% Redeploy·JSON 눈으로 확인은 사람이 빠릅니다.


📋 재사용 프롬프트

텔레그램봇에서 py로 작업하여 KML 다운로드 후

기존에 파이썬으로 작업하여 다운받은 파일이 해당위치에 있어 Downloads\삼성역 근처 맛집 및 정보 지도.kml Python으로 CSV 변환하고 Folder 안 Placemark, Point 좌표도 같이 CSV에 필수적으로 들어가야해

점심 추천 앱

CSV 147곳이 추출되었을 거야. Vanilla JS 단일 HTML: 랜덤 버튼을 생성하고, 모달(이름·별점·후기), Maps는 latitude,longitude 좌표 URL. write_file로 구축해줘.

CSV→JSON (name 빈값)

csv가 제대로 읽지못하고 있어. CSV utf-8-sig BOM 제거, description 콤마 quotechar 처리를 진행해줘 그리고 name 필드 부타이 1막 들어갔는지 JSON 3줄만 보여줘서 테스트 해봐.

Vercel 404

vercel.app 404. repo 파일 목록 + HTML fetch 경로 + index.html 루트 배치 확인. 정적 사이트야, Python serverless 아니니까 다시한번 디버깅해.

배포 검증

push 후 curl로 JSON 200, name·lat·lng 확인하고 Vercel Redeploy 하자.


최종결과물 : 아..... 익숙한 클로드 3.x대 시절의 보라돌이의 향기.... qwen 3.5 9b는 클로드를 닮은 것인가요???.. 지도에서 위치나오는곳은 가게 이름이 나오게 보완할 필요성이 있었습니다.

https://samseong-restaurants.vercel.app/


1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

MC맥돌 프로필 이미지
MC맥돌2026.06.03

로컬로 배포까지!! 이전에 만들었던것보다 퀄리티는 떨어지겠지만 실제 사용할 수있게 만든게 역시 로컬입니다!

무료로 이렇게 까지 간것에 아주 큰 인사이트가 생기네요 ㅎㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기