쟈철
늦기 전에 먼저 보채는 지하철 에이전트. 목적지·도착 시간·준비 시간을 넣으면
서울시 실시간 지하철 도착정보로 "언제 준비하고 언제 나가야 하는지"를 반말로 보챈다.
실행
-
서울 열린데이터광장에서 실시간 지하철 인증키를 발급받는다.
-
.env.example을 .env로 복사하고 키를 넣는다.
-
전체 노선도 만들기 (운행 시간에 한 번):
python3 build_network.py
-
서버 실행 후 http://localhost:5173
python3 server.py
서버에 올리기
| 올리는 방법 | 되는 것 |
|---|
index.html 하나만 (정적 호스팅) | 전체 노선·경로·보채기 전부. 열차 시각은 배차 간격으로 추정 |
폴더 전체 + python3 server.py (+ .env) | 위에 더해 실시간 열차 위치·도착 시각 |
index.html 안에 전체 노선도가 들어 있어서 파일 하나만 올려도 된다
(build_network.py를 돌리면 자동으로 갱신됨).
실시간은 API 키를 숨겨야 하고 서울시 API가 http라서, 브라우저가 직접 못 부르고 서버(server.py)가 꼭 필요하다.
(선택) 채팅에 Claude 연결
채팅창에 직접 쓴 질문을 Claude가 상황(목표·계획·경로)을 보고 반말로 대답한다.
없으면 내장 대답(키워드 매칭 + 여러 말투)으로 동작한다.
- Python 3.10 이상에서
pip install -r requirements.txt
.env에 ANTHROPIC_API_KEY=... 추가 (console.anthropic.com 에서 발급, 사용량만큼 과금)python3 server.py 다시 실행 → 시작 메시지에 "Claude 채팅 켜짐"
모델은 claude-opus-5-5 (effort low), 바꾸려면 .env에 CLAUDE_MODEL=....
화면
넘겨 보는 세 화면 (폰은 옆으로 밀기, 컴퓨터는 위 탭이나 ←→ 키) + 맨 밑엔 지금 오는 열차가 항상 보임.
- 목표: 출발역·도착역·도착 시각(930, 9:30, 오후 3시처럼 쳐도 됨)·준비 시간. 🎤 누르고 "홍대입구에서 강남 9시까지 준비 30분"처럼 말해도 됨. 다 채우고 세팅.
- 지금 상황: 원이 1초마다 흘러감. 늦으면 빨강("미쳤니? 지금이라도 나가."), 30분 넘게 늦으면 검정("걍 가지마. 집에서 자."). 원 가운데나 '쟈철한테 물어봐'를 누르면 알람 창.
- 내 모습: 경로 위를 GPS 따라 달리는 내 캐릭터.
알람 창은 세팅 직후, 상태가 바뀔 때, 늦으면 설정한 간격마다 뜬다. ★는 내 경로 저장(지금은 이 기기에만).
아두이노
설정 > 아두이노 연결 (크롬·엣지, https나 localhost). 속도 9600, 한 줄씩 주고받는다.
| 방향 | 내용 | 뜻 |
|---|
| 아두이노 → 화면 | ALARM | 알람 창 열기 (버튼) |
| 화면 → 아두이노 | MOOD:free / prep / go / late / doomed | 지금 상태가 바뀔 때 |
| 화면 → 아두이노 | ALARM:<상태> | 알람 창이 떴을 때 |
예제: arduino/jachul_button/jachul_button.ino (버튼 2번, LED 9·10·11번, 부저 8번).
브라우저 콘솔이나 다른 코드에선 jachul.alarm(), jachul.mood()로도 부를 수 있다.
구조
index.html: 화면 전부 (목표 · 말하기 · 원 · 알람 창 · 경로 · 실시간 열차)arduino/: 아두이노 예제 스케치server.py: 페이지 제공 + 실시간 API 프록시 (키는 서버에만 있음, 역별 20초 캐시)build_network.py: 실시간 도착정보(일괄)의 이전역/다음역으로 전체 노선도 생성 → data/network.jsonlines.py: 노선 색·평균 소요·배차 간격
