OrganiX Agent

OrganiX Agent

| Twitter @0xOrganix

OrganiX は、Claude 3.7 との統合、MCP（Model Context Protocol）、マルチエージェントの連携、ブロックチェーン接続を備えた、強力なクロスプラットフォーム機能を持つ高度な AI エージェントプラットフォームです。

目次

1. 主な機能
2. システムアーキテクチャ
3. メモリシステム
4. クイックスタート
5. 環境変数
6. CLI リファレンス
7. ユーザーインターフェース
8. 高度な機能
9. プロジェクト構成
10. ドキュメント
11. 要件
12. ライセンス
13. 謝辞

主な機能

• 🧠 高度なマルチエージェントシステム：特化型エージェントが連携し、さまざまな種類のクエリに対応します
• 🪄 ゼロ知識統合：ZK 証明を通じて、プライバシーを保護しながら検証できます
• 🔗 ブロックチェーンと Phantom Wallet：Phantom Wallet との接続による Solana ブロックチェーンの統合
• 🛠️ MCP の完全サポート：Composio の Model Context Protocol を使用して外部ツールを統合できます
• 💡 AGI の推論能力：複数のエージェントが連携し、複雑な推論を行います
• 🧩 強化されたメモリ：重要度評価とキャッシュを備えた多層メモリシステム
• 🔍 ウェブリサーチ：検索と情報抽出を統合しています
• 💬 会話管理：複数の会話セッションを保存、読み込み、管理できます
• 🖥️ クロスプラットフォーム：Windows、Linux、クラウド環境でシームレスに動作します
• 📱 複数のインターフェース：CLI、ターミナルダッシュボード、ウェブダッシュボードを選択できます

システムアーキテクチャ

graph TD
    User[User] --> UI[User Interface]
    UI --> Agent[Core Agent]
    
    Agent --> MultiAgent[Multi-Agent Coordinator]
    Agent --> Memory[Memory System]
    Agent --> MCP[MCP Manager]
    
    MultiAgent --> ResearchAgent[Research Agent]
    MultiAgent --> CodeAgent[Code Agent]
    MultiAgent --> BlockchainAgent[Blockchain Agent]
    MultiAgent --> MCPAgent[MCP Agent]
    MultiAgent --> AGIAgent[AGI Reasoning Agent]
    
    MCP --> ComposioAPI[Composio API]
    MCP --> ExternalTools[External Tools]
    
    Agent --> Claude[Claude 3.7 API]
    Agent --> Blockchain[Blockchain Integration]
    Blockchain --> Solana[Solana Network]
    Blockchain --> ZK[Zero-Knowledge Proofs]
    Blockchain --> Phantom[Phantom Wallet]
    
    Memory --> EpisodicMem[Episodic Memory]
    Memory --> SemanticMem[Semantic Memory]
    Memory --> ProceduralMem[Procedural Memory]
    
    subgraph "User Interfaces"
        CLI[CLI Interface]
        TUI[Terminal Dashboard]
        WebUI[Web Dashboard]
    end
    
    UI --> CLI
    UI --> TUI
    UI --> WebUI

メモリシステム

強化されたメモリシステムでは、ChromaDB をベクトルの保存と検索に使用し、次の 3 種類のメモリを提供します。

graph LR
    A[User Query] --> B[Agent Processing]
    B --> C[Memory System]
    
    C --> D[Episodic Memory]
    C --> E[Semantic Memory]
    C --> F[Procedural Memory]
    
    D -->|Stores| G[Conversations]
    D -->|Tracks| H[User Interactions]
    
    E -->|Stores| I[Key Facts]
    E -->|Organizes| J[Research Results]
    
    F -->|Records| K[Tool Usage Patterns]
    F -->|Remembers| L[System Operations]
    
    C --> M[Memory Maintenance]
    M -->|Prunes| N[Old Memories]
    M -->|Preserves| O[Important Memories]
    
    C --> P[Memory Retrieval]
    P -->|Based on| Q[Relevance]
    P -->|Filtered by| R[Importance]
    P -->|Organized by| S[Timeframe]

クイックスタート

起動スクリプトを使用する（推奨）

最も簡単な始め方は、ランチャーを使用することです。

1. このリポジトリをクローンします

git clone [email protected]:MCPVOT/claude-agent-mcp.git
# or HTTPS: https://github.com/MCPVOT/claude-agent-mcp.git
cd claude-agent-mcp

2. お使いのプラットフォーム用のランチャーを実行します。

   • Windows：launch_agent.bat
   • Linux/Mac：./launch_agent.sh

3. 画面に表示されるメニューに従って環境を初期化し、エージェントを起動します

手動セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします。
   • Windows：install_dependencies.bat
   • Linux/Mac：./install_dependencies.sh
3. API キーを記載した .env ファイルを作成します（環境変数のセクションを参照）
4. 仮想環境を有効にします。
   • Windows：venv\Scripts\activate
   • Linux/Mac：source venv/bin/activate
5. エージェントを実行します：python agent.py

パッケージとしてインストールする（任意）

このプロジェクトには pyproject.toml が含まれているため、パッケージとしてインストールすることもできます。

pip install -e .

これにより、コンソールエントリーポイント claude-agent が利用できるようになります（agent:main に対応します）。

claude-agent --query "Hello, who are you?"

環境変数

プロジェクトのルートに .env ファイルを作成し、次の変数を設定します（.env.example からコピーしてください）。

# Required
ANTHROPIC_API_KEY=your_anthropic_api_key_here
CLAUDE_MODEL=claude-3-7-sonnet-20250219

# Optional - Web Research
EXA_API_KEY=your_exa_api_key_here

# Optional - MCP Integration (Composio)
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_CONNECTION_ID=your_composio_connection_id_here
COMPOSIO_INTEGRATION_ID=your_composio_integration_id_here
COMPOSIO_BASE_URL=your_composio_base_url_here

# Optional - Blockchain
SOLANA_NETWORK=mainnet-beta
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_PRIVATE_KEY=your_solana_private_key_here

# Optional - Zero-Knowledge Proofs
ENABLE_ZK_PROOFS=false

# Optional - Social Media (Twitter/X)
TWITTER_BEARER_TOKEN=your_twitter_bearer_token_here
TWITTER_API_KEY=your_twitter_api_key_here
TWITTER_API_SECRET=your_twitter_api_secret_here
TWITTER_ACCESS_TOKEN=your_twitter_access_token_here
TWITTER_ACCESS_SECRET=your_twitter_access_secret_here

注： 実際の .env ファイルは決してコミットしないでください。Git の追跡対象から除外されています。追跡されるのは .env.example のテンプレートのみです。

CLI リファレンス

フラグ	短縮形	説明
--query	-q	処理するクエリ
--stream	-s	応答をリアルタイムでストリーミングする
--research	-r	トピックを調査する
--max-tokens	-m	Claude の応答に使用する最大トークン数（デフォルト：4096）
--tools	-t	クエリにツールを使用する
--extended-thinking	-e	拡張思考モードを使用する
--save		会話を指定したファイルに保存する
--load		指定したファイルから会話を読み込む
--maintenance		メモリのメンテナンスを実行する

ユーザーインターフェース

ターミナルダッシュボード

# Launch the dashboard
python dashboard.py

# Start dashboard with initial query
python dashboard.py --query "What's the latest news on AI?"

拡張ダッシュボードでは、以下を利用できます。

• Markdown レンダリングに対応したリアルタイムの会話履歴
• システム情報のモニタリング
• 詳細なメモリ統計と分析
• ツールの利用可否インジケーター
• 複数の会話の管理
• モデルの切り替え機能
• 拡張思考オプションを備えたインタラクティブなクエリ入力

コマンドラインインターフェース

# Process a query
python agent.py --query "What is quantum computing?"

# Stream a response (real-time output)
python agent.py --query "Tell me about quantum computing" --stream

# Use tools for a query
python agent.py --query "List the files in my current directory" --tools

# Use extended thinking mode
python agent.py --query "Explain the theory of relativity" --extended-thinking

# Research a topic
python agent.py --research "Climate change solutions"

# Display agent information
python agent.py

# Perform memory maintenance
python agent.py --maintenance

# Save conversation to file
python agent.py --save my_conversation.json

# Load conversation from file
python agent.py --load my_conversation.json

Web ダッシュボード

# Start the web server (default: http://localhost:8080)
python web_server.py

# Custom host/port
python web_server.py --host 0.0.0.0 --port 9000

ブラウザーで http://localhost:8080 を開きます。

高度な機能

マルチエージェントシステム

OrganiX は、専門エージェントを備えたマルチエージェントアーキテクチャを採用しています。

エージェント	専門分野
リサーチスペシャリスト	詳細な調査と情報の統合
コードスペシャリスト	高品質なコードソリューション
ブロックチェーンスペシャリスト	Solana ブロックチェーンの専門知識
MCP スペシャリスト	Model Context Protocol の統合
AGI 推論スペシャリスト	複雑な推論と認知

# Use collaborative reasoning with multiple agents
result = await coordinator.collaborative_reasoning(
    "Compare traditional finance with DeFi on Solana",
    agents=["researcher", "blockchain", "agi_reasoner"]
)

ブロックチェーンと Phantom Wallet の統合

# Get Solana account balance
balance = await solana_integration.get_solana_balance(address)

# Connect to Phantom wallet
connection_url = solana_integration.generate_phantom_connection_url(
    dapp_url="https://example.com",
    redirect_url="https://example.com/callback"
)

ゼロ知識証明

# Create a proof of knowledge
proof = await zk_proofs.create_proof_of_knowledge(sensitive_data)

# Verify a proof
verification = zk_proofs.verify_proof(proof)

MCP ツールの統合

# Register a custom tool
mcp_manager.register_tool(
    "calculate_mortgage",
    "Calculate mortgage payments",
    calculate_mortgage_function
)

# Process with MCP tools
result = await mcp_manager.process_with_tools(
    "What's my monthly payment on a $300,000 loan at 4.5% for 30 years?"
)

プロジェクト構成

claude-agent-mcp/
├── agent.py                   # Core agent entry point (CLI)
├── advanced_chat.py           # Advanced chat: personas, context awareness
├── blockchain_integration.py  # Solana + Phantom wallet + ZK proofs
├── brave_integration.py       # Brave search integration
├── claude_client.py           # Claude 3.7 API client (streaming, extended thinking)
├── composio_integration.py    # Composio MCP integration
├── config_manager.py          # Configuration management
├── dashboard.py               # Terminal dashboard (TUI)
├── mcp_manager.py             # MCP tool registration & orchestration
├── memory_system.py           # Multi-tiered memory (ChromaDB)
├── model_manager.py           # Model management & switching
├── social_integrations.py     # Social platform integrations
├── system_bridge.py           # System command bridge
├── twitter_integration.py     # Twitter/X integration
├── utils.py                   # Shared utilities
├── web_research.py            # Web research & search
├── web_server.py              # Web dashboard server (aiohttp, :8080)
├── web_dashboard/             # Web dashboard frontend assets
├── docs/                      # Extended documentation
├── DOCUMENTATION.md           # Full user documentation
├── .env.example               # Environment variable template
├── pyproject.toml             # Package metadata (console script: claude-agent)
├── requirements.txt           # Python dependencies
├── install_dependencies.sh    # Linux/macOS dependency installer
├── install_dependencies.bat   # Windows dependency installer
├── launch_agent.sh            # Linux/macOS launcher
└── launch_agent.bat           # Windows launcher

ドキュメント

完全なドキュメントについては、DOCUMENTATION.md をご覧ください。アーキテクチャ、コアコンポーネント、マルチエージェントシステム、メモリシステム、MCP 統合、ブロックチェーンと ZK 証明、API リファレンス、デプロイ、トラブルシューティングを網羅しています。

要件

• Python 3.10 以上
• requirements.txt に記載された依存関係

ライセンス

MIT ライセンス

謝辞

• Anthropic Claude 3.7 を使用して構築
• ベクトルストレージに ChromaDB を使用
• Web 検索機能を Exa で強化
• MCP に Composio を統合
• Solana および Phantom に接続
• ターミナル UI は Rich を使用