Claude Code / Codex で動く群体知能シミュレーションエンジン
Swarm Intelligence Simulation Engine powered by Claude Code / Codex

English | 日本語

CodeFish は MiroFish をフォークし、Claude Code および Codex のCLIサブスクリプションだけでマルチエージェントシミュレーションを実行できるようにしたエンジンです。

テキストファイル（ニュース記事、レポート、小説など）をシードとしてアップロードし、自然言語でプロンプトを書くだけで、数千体のエージェントが独立した人格・記憶・行動ロジックを持つパラレルワールドを自動構築。群体インタラクションを通じて未来の動向を予測します。

必要なもの: Claude Code または Codex のサブスクリプション + Zep Cloud（無料枠で十分） 追加のAPI費用: なし（CLIプロキシ経由で既存サブスクを活用）

• 定額制 — Claude Code / Codex のサブスクだけで動く。従量課金のAPI不要
• プロバイダー切替 — --provider claude or --provider codex で即座に切り替え
• 日本語UI — フロントエンド全画面を日本語化済み
• OpenAI互換プロキシ — claude_code_proxy.py がCLIをOpenAI API形式でラップ

1. グラフ構築 — シードテキストから知識グラフ（GraphRAG）を自動構築
2. 環境構築 — エンティティ抽出、ペルソナ生成、シミュレーションパラメータ設定
3. シミュレーション — マルチエージェント並列シミュレーション実行
4. レポート生成 — ReportAgentがシミュレーション結果を分析・レポート化
5. 深層インタラクション — シミュレーション世界の任意のAgentと対話可能

cp .env.example .env

.env を編集：

# LLM API — CLIプロキシ経由
LLM_API_KEY=dummy
LLM_BASE_URL=http://127.0.0.1:8888/v1
LLM_MODEL_NAME=claude-code   # or codex

# Zep Cloud（無料枠で十分）
# https://app.getzep.com/ でAPIキーを取得
ZEP_API_KEY=your_zep_api_key

# 全依存一括インストール
npm run setup:all

または個別に：

npm run setup          # Node依存（ルート + フロントエンド）
npm run setup:backend  # Python依存（バックエンド、仮想環境自動作成）

# Claude Code を使う場合
python3 claude_code_proxy.py --provider claude --port 8888

# Codex を使う場合
python3 claude_code_proxy.py --provider codex --port 8888

# フロントエンド + バックエンドを同時起動
npm run dev

• フロントエンド: http://localhost:3000
• バックエンド API: http://localhost:5001
• CLIプロキシ: http://127.0.0.1:8888/v1

cp .env.example .env
# .env を編集後:
docker compose up -d

• フォーク元: MiroFish by 666ghj
• シミュレーションエンジン: OASIS by CAMEL-AI

AGPL-3.0