first commit

README.md

@@ -0,0 +1,40 @@
+# Jarvis (라즈베리 Pi 음성 비서)
+
+호출어 + STT + Gemini + Home Assistant 연동.
+
+## 경로
+
+```
+/home/hoon/projects/jarvis/
+├── jarvis.py              # 메인
+├── jarvis.env             # API 키·설정 (Git 제외)
+├── jarvis_runtime.json    # 실시간 튜닝 (stt_backend 등)
+├── jarvis_hooks/          # HA API
+├── jarvis_models/         # openWakeWord 모델
+├── jarvis_env/            # Python venv (Git 제외)
+└── jarvis_logs/           # 질문/답변 로그 (Git 제외)
+```
+
+## 실행
+
+```bash
+systemctl --user restart jarvis
+systemctl --user status jarvis
+```
+
+## STT 전환
+
+`jarvis_runtime.json`:
+
+```json
+"stt_backend": "web"
+```
+
+- `web` — 무료 Google Web Speech
+- `cloud` — Google Cloud Speech-to-Text (유료)
+
+## HA 엔티티 동기화
+
+```bash
+python3 jarvis_hooks/ha_api.py sync
+```