AI导哈

自主AI代理基础设施

Project Chimera是一个用于构建和部署自主AI影响者的操作系统，采用规范驱动开发（SDD）确保可靠性和安全性。

  • by der-bew
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 der-bew/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<br/>(Strategy & Task Gen)"]
    end

    subgraph "Swarm Nodes (Spokes)"
        Worker1[Worker: Image Gen]
        Worker2[Worker: Twitter Poster]
        Worker3[Worker: Transaction]
        Judge["Judge Agent<br/>(QA & Safety)"]
        CFO["CFO Judge<br/>(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管道，以确保代码质量和安全性。

🔧 技术栈

层 技术
运行时 Python 3.10+，异步IO
编排 Redis（队列）、Celery/BullMQ
数据 PostgreSQL（事务性），Weaviate（向量/RAG）
AI/ML 克劳德作品4.5（推理），双子座3闪光（任务）
协议 模型上下文协议（MCP）
商业 Coinbase代理工具包（基础网络）
工具 uv, Ruff, Pytest, Docker

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

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

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

相关 MCP