あなたもぷちを
迎えよう。

M5Stack にファームウェアを書き込む

m5_petit リポジトリのファームウェアを Arduino IDE で書き込む。 キャラクターごとに m5_petit_puchiteya・m5_petit_puchiko・m5_petit_puchiru のフォルダがある。 Wi-Fi の SSID・パスワードと PC の IP アドレスを config.h に記入してから書き込む。

embodied-claude を clone してセットアップする

embodied-claude を clone し、依存関係をインストール。

git clone https://github.com/fruitriin/embodied-claude.git
cd embodied-claude
for dir in m5-mcp memory-mcp desire-system dashboard; do
  (cd "$dir" && uv sync)
done

キャラクターを作る

create_character.py でキャラクターを追加。設定ファイルと cron が自動で作られる。

uv run python create_character.py mychar 私のぷち "#ff9999" 192.168.1.100

作成後、~/petit_claude/characters/mychar/SOUL.md を編集して性格を書く。ここが一番楽しい部分。

GPU サーバーをセットアップする（オプション）

音声認識（Whisper）・話者認識（resemblyzer）を GPU PC で動かす。 m5_petit_gpu_server を GPU PC に clone して起動。

git clone https://github.com/AiriYokochi/m5_petit_gpu_server.git
cd m5_petit_gpu_server/m5_petit_voice_recognition
uv sync
uv run uvicorn m5_petit_voice_recognition.main:app \
  --host 0.0.0.0 --port 8765

ダッシュボードを起動する

環境変数 VOICE_API_HOST に GPU サーバーのホスト名を設定してから起動。

cd dashboard
VOICE_API_HOST=your-gpu-pc uv run python main.py

http://localhost:8765 をブラウザで開くとダッシュボードが見える。 M5Stack の電源を入れると自動で接続される。

声を登録する（オプション）

自分や家族の声を登録すると、M5Stack が誰が話しかけているかを認識できるようになる。

# 設定ファイルを作成
echo '{"my_speaker_id":"yourname","my_username":"yourname"}' \
  > ~/petit_claude/speaker_config.json

# 登録スクリプトを実行してからMICボタンを押す
./scripts/register_speaker.sh