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

작성일: 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가지
결과물 퀄리티 비교 과거 Cursor를 활용해 만들었던 애플리케이션과, 이번에 오직 로컬 모델만으로 작성한 애플리케이션의 전반적인 완성도와 퀄리티 차이를 비교해 봅니다.
로컬 모델의 한계 및 성능 테스트 비교적 가벼운 모델인 Qwen 3.5 9B 로컬 모델이 실제 애플리케이션 기획 및 개발 과정에서 어디까지 역할을 수행할 수 있는지 그 한계를 테스트합니다.
실제 배포 가능성 검증 정말로 파라미터가 낮은 로컬 모델의 코딩 능력만으로도, 오류 없이 애플리케이션을 완성하고 Vercel에 배포까지 완결성 있게 진행할 수 있는지 확인합니다.
전날 텔레그램에서 HTML 계산기 file tool까지 성공했습니다. 이번엔 IDE 없이 폰 채팅만으로 실서비스를 만들어 보기로 했어요.
점심메뉴 추천 어플리케이션
1. 버튼 → 자동 추천
2. 팝업 → 식당명, 별점, 후기, 구글 지도 링크
3. 링크 클릭 → 웹에서 Maps 열림
백데이터: Google My Maps KML → CSVVanilla 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 | |
Vercel | |
로컬 테스트 | 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 tools4-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.json7-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.06004248-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/
메인화면
랜덤추천을 눌렀을 경우

구글 지도로 이동을 눌렀을 때

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

메뉴추천을 눌렀을 경우

링크를 눌렀을 경우 지도이동

14. 두개의 바이브코딩으로 만든 작품의 비교
항목 | 과거 cursor작품 | 현재 로컬 LLM작품 | 차이원인 |
|---|---|---|---|
사용모델 | cursor + Claude 3.5 Sonnet | hermes + qwen3.5 9b | 과거작은 2년전 완성. |
랜덤추천버튼 | 있음 | 있음 | 둘다 프롬프트는 추천버튼을 만들어달라고 함. |
지도 | 구글 map 좌표이용 | 구글 map 좌표로 네이버 또는 구글 주소 컨버전 | 컨버전이 DB자료양이 많아 컨텍스트를 많이먹어 로컬은 하지않음. |
15. 마무리 결론 !!
hermes + Qwen 3.5 텔레그램봇만으로 앱 만들기는 가능합니다. — KML 147곳, HTML, git push까지 Qwen3.5-9B + Hermes tool call로 갔습니다. 퀄리티가 엄청 좋다는 아니지만 꽤 쓸만한 형태까지 나오는것으로 보입니다. 과거 2년전 만든 앱과 비교했을때 퀄리티는 다소 떨어집니다만 이정도면 쓸만하다고 생각합니다.
로컬 OK ≠ Vercel OK — localhost:8080과 vercel.app 사이에 Git tracking·fetch 경로·Redeploy 3단계가 있습니다.
가장 긴 구간은 코딩이 아니라 데이터입니다. — Phase 6~7의 BOM·콤마·파일명·fetch·Maps 좌표. 로컬의 컨텍스트 길이안에 데이터의 크기가 들어오기가 참 어렵습니다.
"name": ""은 모델 문제가 아니라 CSV 파싱 — UTF-8 BOM + description 내 콤마. JSON 열어보면 5초 만에 의심 가능.
Maps는 이름 검색 말고 좌표 — KML에 lat/lng가 있으니 query=37.xx,127.xx가 정확합니다.
봇 "완성!"은 3번 확인 — (1) Explorer/JSON (2) localhost (3) curl 배포 URL.
compression은 배포 디버깅의 적 — 193 messages 압축 후 fetch 경로를 또 틀리게 patch.
스킬 자동 생성 — kml-csv-conversion-and-web-app-deployment → kml-csv-json-conversion-and-web-app-deployment.
최종 한 줄 — 텔레그램 봇은 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 하자.



로컬로 배포까지!! 이전에 만들었던것보다 퀄리티는 떨어지겠지만 실제 사용할 수있게 만든게 역시 로컬입니다!
무료로 이렇게 까지 간것에 아주 큰 인사이트가 생기네요 ㅎㅎ