* neko
「吾輩は猫である」をモチーフにした、Raspberry Pi上で動く完全ローカルな猫キャラクター AI 家電コントローラー。
♥ LOCAL LLM
* Gemma 4 E2B（音声・画像・テキストのマルチモーダル）on llama.cpp
ドキュメント
| ファイル | 内容 |
|---|---|
| REQUIREMENTS.md | プロダクト要件・採用技術・現状環境（最初に読む） |
| TODO.md | 残タスク・既知の改善余地 |
| CLAUDE.md | クイックリファレンス（AIアシスタント向け） |
| docs/ARCHITECTURE.md | システム設計図（Mermaid図、シーケンス、状態機械、ユーザーフロー） |
| docs/SETUP.md | セットアップ手順 |
ハードウェア
- ▶Raspberry Pi 5 (8GB) microSD 64GB
- ▶PiSugar Whisplay HAT 240×280 LCD、WM8960オーディオ、ボタン、RGB LED
- ▶マイク・スピーカー Whisplay内蔵
- ▶Pi Camera Module オプション、未接続時は自動でスキップ
- ▶周辺機器 Nature Remo、SwitchBot、Echoデバイス等
ソフトウェア
| 役割 | 採用技術 |
|---|---|
| 推論エンジン | llama.cpp（build b8766+、ARM NEON最適化） |
| LLM | gemma-4-E2B-it-Q4_K_M.gguf + mmproj-BF16.gguf |
| 音声入力 | Gemma 4 ネイティブ音声入力（Whisper不要） |
| VAD（発話検知） | silero-vad |
| TTS | pyopenjtalk + Nitech HTS Voice |
| LCD/LED/Button | PiSugar Whisplay Driver + rpi-lgpio |
| カメラ | Picamera2 / libcamera |
| 家電API | Nature Remo Cloud、SwitchBot v1.1 |
クイックスタート
★ COMMANDS
# Macから Pi に接続 ssh neko-pi # Pi上で起動（llama-server は既に立ち上げ済み前提） cd ~/neko setsid bash /tmp/neko_runner.sh < /dev/null > /tmp/neko.log 2>&1 & disown # 動作：マイクに話しかける → 1秒無音で送信 → 猫の応答 tail -f /tmp/neko.log
ライセンス・謝辞
* このリポジトリ自体のライセンスは未定。
★ 依存外部資源
llama.cppMIThttps://github.com/ggml-org/llama.cpp
Gemma 4Apache 2.0https://huggingface.co/google/gemma-4-E2B-it
pyopenjtalkMIThttps://github.com/r9y9/pyopenjtalk
silero-vadMIThttps://github.com/snakers4/silero-vad
PiSugar WhisplayMIThttps://github.com/PiSugar/Whisplay