Project Chimera

奇美拉项目：代理基础设施

构建自主影响者的工厂。

规范驱动的Python MCP

Mission：构建一个强大的工程环境，其中Intent（Specs）是事实的来源，Infrastructure（CI/CD、Tests、Docker）确保AI代理车队的可靠性。

📜 执行摘要

奇美拉项目不是人工智能聊天机器人。它是自主AI影响者网络的操作系统。我们反对“氛围编码”，支持严格的规范驱动开发（SDD）。

这个存储库代表了“工厂车间”——部署数千个可以自主感知、推理和交易的目标导向数字实体所需的基础设施、测试工具和编排逻辑。

🏗️ 架构概述

我们利用具有轮辐拓扑的FastRender Swarm模式来确保可扩展性和弹性。

• 中心（编排器）：管理全局状态、活动目标和车队健康状况。

• 蜂群（代理人）：

  - Planner: Decomposes high-level goals into a DAG of tasks.
  - Worker: Executes atomic tasks using MCP Tools.
  - Judge: Validates output against persona constraints and safety protocols (HITL).

• 辐条（MCP层）：与外部世界（推特、Coinbase、Weaviate）的标准化接口。

graph TD
    subgraph "The Chimera Core (Hub)"
        Orchestrator[Central Orchestrator]
        Planner["Planner Agent
(Strategy & Task Gen)"]
    end

    subgraph "Swarm Nodes (Spokes)"
        Worker1[Worker: Image Gen]
        Worker2[Worker: Twitter Poster]
        Worker3[Worker: Transaction]
        Judge["Judge Agent
(QA & Safety)"]
        CFO["CFO Judge
(Budget Check)"]
    end

    subgraph "External World (MCP Layer)"
        Twitter[(MCP Twitter Server)]
        ImgGen[(MCP Image Server)]
        Wallet[(MCP Coinbase AgentKit)]
        DB[(Weaviate & PG)]
    end

    Orchestrator --> Planner
    Planner -->|Task Queue| Worker1
    Planner -->|Task Queue| Worker2
    Planner -->|Task Queue| Worker3

    Worker1 -->|Result| Judge
    Worker2 -->|Result| Judge
    Worker3 -->|Result| CFO

    CFO -->|Approved| Judge
    Judge -->|Final Check| Orchestrator

    Worker1 -.->|Tool Call| ImgGen
    Worker2 -.->|Tool Call| Twitter
    Worker3 -.->|Tool Call| Wallet
    
    Planner -.->|Read Memory| DB
    Judge -.->|Update Memory| DB

    style Orchestrator fill:#f9f,stroke:#333,stroke-width:2px
    style Judge fill:#ff9,stroke:#333,stroke-width:2px
    style CFO fill:#f96,stroke:#333,stroke-width:2px

📁 项目结构

frontend/
    app/
        globals.css
        layout.tsx
        page.tsx
    package.json
specs/
    functional.md
    technical.md
src/
    chimera/
        api/
            main.py
    main.py
tests/
research/
skills/

🚀 快速开始

1. 再进行

    # Install uv if you haven't: pip install uv
    uv sync

1. 配置环境

    cp .env.example .env
    # Edit .env with your API Keys (Anthropic, Coinbase, etc.)

1. 经营工厂

    # Activate the virtual shell
    source .venv/bin/activate

    # Run the infrastructure checks (Tests)
    make test

    # Start a local worker agent
    python -m chimera.cli start-worker

🛠️ 发展理念

规范驱动开发（SDD）

未经批准的规范禁止使用实现代码。

1. 规范一：定义合同 specs/technical.md.
2. 测试二：在中编写一个失败的测试 tests/.
3. 最后一个代码：仅实现以满足测试和规范。

黄金法则

1. 仅限MCP：所有外部交互都必须通过模型上下文协议。代理逻辑中没有直接的API调用。
2. 严格打字：所有数据结构都必须使用pydantic。基线模型。
3. 治理：每个提交都运行CI管道，以确保代码质量和安全性。

🔧 技术栈

🤝 贡献（针对人类和代理人）

在贡献之前，请确保您的IDE上下文已加载 .cursor/rules.

1. 结账 最新的主。
2. 规格 你的变化 specs/.
3. 测试 在本地进行更改（进行测试）。
4. 公关 必须引用它所满足的特定规范ID。