쟈철

늦기 전에 먼저 보채는 지하철 에이전트. 목적지·도착 시간·준비 시간을 넣으면 서울시 실시간 지하철 도착정보로 "언제 준비하고 언제 나가야 하는지"를 반말로 보챈다.

실행

1. 서울 열린데이터광장에서 실시간 지하철 인증키를 발급받는다.

2. .env.example을 .env로 복사하고 키를 넣는다.

3. 전체 노선도 만들기 (운행 시간에 한 번):

   python3 build_network.py
   

4. 서버 실행 후 http://localhost:5173

   python3 server.py
   

서버에 올리기

올리는 방법	되는 것
index.html 하나만 (정적 호스팅)	전체 노선·경로·보채기 전부. 열차 시각은 배차 간격으로 추정
폴더 전체 + python3 server.py (+ .env)	위에 더해 실시간 열차 위치·도착 시각

index.html 안에 전체 노선도가 들어 있어서 파일 하나만 올려도 된다 (build_network.py를 돌리면 자동으로 갱신됨). 실시간은 API 키를 숨겨야 하고 서울시 API가 http라서, 브라우저가 직접 못 부르고 서버(server.py)가 꼭 필요하다.

(선택) 채팅에 Claude 연결

채팅창에 직접 쓴 질문을 Claude가 상황(목표·계획·경로)을 보고 반말로 대답한다. 없으면 내장 대답(키워드 매칭 + 여러 말투)으로 동작한다.

1. Python 3.10 이상에서 pip install -r requirements.txt
2. .env에 ANTHROPIC_API_KEY=... 추가 (console.anthropic.com 에서 발급, 사용량만큼 과금)
3. python3 server.py 다시 실행 → 시작 메시지에 "Claude 채팅 켜짐"

모델은 claude-opus-5-5 (effort low), 바꾸려면 .env에 CLAUDE_MODEL=....

화면

넘겨 보는 세 화면 (폰은 옆으로 밀기, 컴퓨터는 위 탭이나 ←→ 키) + 맨 밑엔 지금 오는 열차가 항상 보임.

1. 목표: 출발역·도착역·도착 시각(930, 9:30, 오후 3시처럼 쳐도 됨)·준비 시간. 🎤 누르고 "홍대입구에서 강남 9시까지 준비 30분"처럼 말해도 됨. 다 채우고 세팅.
2. 지금 상황: 원이 1초마다 흘러감. 늦으면 빨강("미쳤니? 지금이라도 나가."), 30분 넘게 늦으면 검정("걍 가지마. 집에서 자."). 원 가운데나 '쟈철한테 물어봐'를 누르면 알람 창.
3. 내 모습: 경로 위를 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.json
• lines.py: 노선 색·평균 소요·배차 간격