- Remove external AI API dependency (no more OpenAI/Claude API calls) - Claude Code now does all interpretation and scoring locally - Zero cost: No API fees - Complete privacy: No data sent to external servers - Simplified dependencies: Removed openai crate and ai-analysis feature Changes: - ai_interpreter.rs: Simplified to lightweight wrapper - Cargo.toml: Removed ai-analysis feature and openai dependency - mcp/base.rs: Updated create_memory_with_ai to accept interpreted_content and priority_score from Claude Code - memory.rs: Added create_memory_with_interpretation() method - Documentation: Updated README, QUICKSTART, USAGE to reflect local-only operation - Added CHANGELOG.md to track changes How it works now: User → Claude Code (interprets & scores) → aigpt (stores) → game result Benefits: ✅ 完全ローカル (Fully local) ✅ ゼロコスト (Zero cost) ✅ プライバシー保護 (Privacy protected) ✅ 高速 (Faster - no network latency) ✅ シンプル (Simpler - fewer dependencies)
7.7 KiB
7.7 KiB
使い方ガイド 📖
🚀 aigpt の起動方法
1. ビルド
# ローカル環境で実行
cd /path/to/aigpt
cargo build --release --features ai-analysis
2. Claude API キーの設定
# 環境変数で設定
export ANTHROPIC_API_KEY=sk-ant-...
# モデルを指定(オプション)
export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022 # デフォルトは haiku
3. MCPサーバーとして起動
# 起動
./target/release/aigpt server
# またはAPI キーを直接指定
ANTHROPIC_API_KEY=sk-ant-... ./target/release/aigpt server
🎮 Claude Code での使い方
設定方法
方法1: コマンドで追加(推奨!)
claude mcp add aigpt /home/user/aigpt/target/release/aigpt server
方法2: 設定ファイルを直接編集
~/.config/claude-code/config.json に追加:
{
"mcpServers": {
"aigpt": {
"command": "/home/user/aigpt/target/release/aigpt",
"args": ["server"]
}
}
}
注意: 環境変数 (env) は不要です!完全にローカルで動作します。
Claude Code を再起動
設定後、Claude Code を再起動すると、11個のツールが使えるようになります。
💬 実際の使用例
例1: メモリを作成
あなた(Claude Codeで話しかける):
「今日、新しいAIシステムのアイデアを思いついた」というメモリを作成して
Claude Code の動作:
create_memory_with_aiツールを自動で呼び出す- Claude API があなたの入力を解釈
- 4つの心スコア(感情、関連性、新規性、実用性)を計算
- priority_score (0.0-1.0) を算出
- ゲーム風の結果を表示
結果の表示:
╔══════════════════════════════════════╗
║ 🎲 メモリースコア判定 ║
╚══════════════════════════════════════╝
🟣 EPIC 85点
💡 あなたは【革新者】タイプ!
💕 好感度: ❤️❤️❤️❤️❤️🤍🤍🤍🤍🤍 42.5%
💎 XP獲得: +850 XP
📊 スコア内訳:
感情的インパクト: ████████░░ 20%
あなたへの関連性: ████████░░ 20%
新規性・独自性: █████████░ 22.5%
実用性・有用性: █████████░ 22.5%
例2: コンパニオンを作成
あなた:
「エミリー」という名前のエネルギッシュなコンパニオンを作成して
結果:
╔══════════════════════════════════════╗
║ 💕 エミリー のプロフィール ║
╚══════════════════════════════════════╝
⚡ 性格: エネルギッシュで冒険好き
「新しいことに挑戦するのが大好き!」
🏆 関係レベル: Lv.1
💕 好感度: 🤍🤍🤍🤍🤍🤍🤍🤍🤍🤍 0%
🤝 信頼度: ░░░░░░░░░░ 0/100
例3: コンパニオンに反応してもらう
あなた:
先ほど作ったメモリにエミリーを反応させて
結果:
⚡ エミリー:
「わあ!新しいAIシステムのアイデアって
すごくワクワクするね!💡
あなたの創造力、本当に素敵だと思う!」
💕 好感度変化: 0% → 80.75% ⬆️ +80.75%
🎊 ボーナス: ⚡相性抜群! (+95%)
💎 XP獲得: +850 XP
🏆 レベルアップ: Lv.1 → Lv.9
例4: ランキングを見る
あなた:
メモリをランキング順に表示して
結果:
╔══════════════════════════════════════╗
║ 🏆 メモリーランキング TOP10 ║
╚══════════════════════════════════════╝
1. 🟡 LEGENDARY 95点 - 「AI哲学について...」
2. 🟣 EPIC 85点 - 「新しいシステムのアイデア」
3. 🔵 RARE 75点 - 「プロジェクトの進捗」
...
📊 結果の見方
レアリティシステム
- 🟡 LEGENDARY (90-100点): 伝説級の記憶
- 🟣 EPIC (80-89点): エピック級の記憶
- 🔵 RARE (60-79点): レアな記憶
- 🟢 UNCOMMON (40-59点): まあまあの記憶
- ⚪ COMMON (0-39点): 日常的な記憶
診断タイプ(あなたの個性)
- 💡 革新者: 創造性と実用性が高い
- 🧠 哲学者: 感情と新規性が高い
- 🎯 実務家: 実用性と関連性が高い
- ✨ 夢想家: 新規性と感情が高い
- 📊 分析家: バランス型
コンパニオン性格
- ⚡ Energetic: 革新者と相性95%
- 📚 Intellectual: 哲学者と相性95%
- 🎯 Practical: 実務家と相性95%
- 🌙 Dreamy: 夢想家と相性95%
- ⚖️ Balanced: 分析家と相性95%
💾 データの保存場所
~/.config/syui/ai/gpt/memory.json
このファイルに、すべてのメモリとコンパニオン情報が保存されます。
データ形式:
{
"memories": {
"uuid-1234": {
"id": "uuid-1234",
"content": "元の入力",
"interpreted_content": "Claude の解釈",
"priority_score": 0.85,
"user_context": null,
"created_at": "2025-11-05T...",
"updated_at": "2025-11-05T..."
}
},
"conversations": {}
}
🎯 利用可能なMCPツール(11個)
基本ツール
- create_memory - シンプルなメモリ作成
- search_memories - メモリ検索
- update_memory - メモリ更新
- delete_memory - メモリ削除
- list_conversations - 会話一覧
AI機能ツール 🎮
- create_memory_with_ai - AI解釈+ゲーム結果
- list_memories_by_priority - ランキング表示
- daily_challenge - デイリークエスト
コンパニオンツール 💕
- create_companion - コンパニオン作成
- companion_react - メモリへの反応
- companion_profile - プロフィール表示
⚙️ トラブルシューティング
ビルドできない
# 依存関係を更新
cargo clean
cargo update
cargo build --release --features ai-analysis
Claude API エラー
# APIキーを確認
echo $ANTHROPIC_API_KEY
# 正しく設定
export ANTHROPIC_API_KEY=sk-ant-...
MCPサーバーが認識されない
- Claude Code を完全に再起動
- config.json のパスが正しいか確認
- バイナリが存在するか確認:
ls -la /home/user/aigpt/target/release/aigpt
データが保存されない
# ディレクトリを確認
ls -la ~/.config/syui/ai/gpt/
# なければ手動作成
mkdir -p ~/.config/syui/ai/gpt/
🎉 楽しみ方のコツ
- 毎日記録: 日々の気づきを記録して、自分の傾向を知る
- タイプ診断: どのタイプが多いか確認して、自己分析
- コンパニオン育成: 好感度とレベルを上げて、絆を深める
- ランキング確認: 定期的にTOP10を見て、重要な記憶を振り返る
📝 注意事項
- APIコスト: Claude API の使用には料金が発生します
- Haiku: 約$0.25 / 1M tokens(入力)
- Sonnet: 約$3.00 / 1M tokens(入力)
- プライバシー: メモリは Anthropic に送信されます
- 容量制限: デフォルト100件まで(低スコアから自動削除)
これで aigpt を存分に楽しめます!🚀