🚀 Make It Heavy

一个基于强大的多智能体系统，旨在模拟 Grok heavy 功能的 Python 框架。Make It heavy 构建于 OpenRouter API 之上，通过智能智能体编排，提供全面、多维度的分析。

🌟 特性

• 🧠 Grok heavy 模拟：多智能体系统，可提供类似 Grok heavy 模式的深度综合分析。
• 🔀 并行智能：同时部署 4 个专业智能体，实现最大的洞察覆盖范围。
• 🎯 动态问题生成：AI 会根据每个查询定制专属的研究问题。
• ⚡ 实时编排：多智能体执行过程中的实时视觉反馈。
• 🛠️ 热插拔工具：自动发现并加载 tools/ 目录下的工具。
• 🔄 智能综合：将多个智能体的视角融合为统一、全面的回答。
• 🎮 单智能体模式：针对简单任务，可运行单个拥有完整工具访问权限的智能体。

🚀 快速开始

先决条件

• Python 3.8+
• uv (推荐的 Python 包管理器)
• OpenRouter API key

安装

1. 克隆并设置环境：

git clone 
cd "make it heavy"

# 使用 uv 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate  # Windows 下: .venv\Scripts\activate

2. 安装依赖：

uv pip install -r requirements.txt

3. 配置 API key：

# 编辑 config.yaml，将 YOUR API KEY HERE 替换为你的 OpenRouter API key

🎯 使用方法

单智能体模式

运行一个拥有完整工具访问权限的智能体：

uv run main.py

功能说明：

• 加载一个拥有所有可用工具的智能体。
• 逐步处理你的查询。
• 使用网页搜索、计算器、文件操作等工具。
• 任务完成后返回全面回复。

示例：

User: Research the latest developments in AI and summarize them
Agent: [Uses search tool, analyzes results, provides summary]

Grok heavy 模式（多智能体编排）

通过 4 个并行智能体模拟 Grok heavy 的深度分析：

uv run make_it_heavy.py

Make It heavy 的工作原理：

1. 🎯 AI 问题生成：从你的查询中生成 4 个专门的研究问题。
2. 🔀 并行智能：同时运行 4 个具有不同分析维度的智能体。
3. ⚡ 实时进度：通过可视进度条显示实时智能体状态。
4. 🔄 智能综合：将所有视角融合成一个全面的 Grok heavy 风格的回答。

执行流程示例：

User Query: "Who is Pietro Schirano?"

AI Generated Questions:
- Agent 1: "Research Pietro Schirano's professional background and career history"
- Agent 2: "Analyze Pietro Schirano's achievements and contributions to technology"  
- Agent 3: "Find alternative perspectives on Pietro Schirano's work and impact"
- Agent 4: "Verify and cross-check information about Pietro Schirano's current role"

Result: Grok heavy-style comprehensive analysis combining all agent perspectives

🏗️ 架构

编排流程

graph TD
    A[User Input] --> B[Question Generation Agent]
    B --> C[Generate 4 Specialized Questions]
    C --> D[Parallel Agent Execution]
    D --> E[Agent 1: Research]
    D --> F[Agent 2: Analysis] 
    D --> G[Agent 3: Alternatives]
    D --> H[Agent 4: Verification]
    E --> I[Synthesis Agent]
    F --> I
    G --> I
    H --> I
    I --> J[Comprehensive Final Answer]

核心组件

1. 智能体系统 (agent.py)

• 自包含：完整的智能体实现，具备工具访问能力。
• Agentic Loop：持续工作直至任务完成。
• 工具集成：自动发现并执行工具。
• 可配置：所有设置均使用 config.yaml。

2. 编排器 (orchestrator.py)

• 动态问题生成：AI 创建专业问题。
• 并行执行：同时运行多个智能体。
• 响应综合：AI 将所有智能体输出进行合并。
• 错误处理：提供优雅的降级方案和错误恢复。

3. 工具系统 (tools/)

• 自动发现：自动加载目录下的所有工具。
• 热插拔：只需将新文件放入 tools/ 即可添加新工具。
• 标准化接口：所有工具均继承自 BaseTool。

可用工具

工具	用途	参数
search_web	使用 DuckDuckGo 进行网页搜索	query, max_results
calculate	安全的数学计算	expression
read_file	读取文件内容	path, head, tail
write_file	创建/覆盖文件	path, content
mark_task_complete	标记任务完成	task_summary, completion_message

⚙️ 配置

编辑 config.yaml 以自定义行为：

# OpenRouter API 设置
openrouter:
  api_key: "YOUR KEY"
  base_url: "https://openrouter.ai/api/v1"
  model: "openai/gpt-4.1-mini"