🚀 Make It Heavy

Make It Heavy 是一个 Python 框架，旨在通过强大的多智能体（Multi-agent）系统模拟 Grok Heavy 的功能。基于 OpenRouter 的 API 构建，Make It Heavy 通过智能的智能体编排，提供全面、多维度的深度分析。

🌟 特性

• 🧠 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)

• 独立性：完整的智能体实现，具备工具调用能力
• 智能体循环：持续工作直至任务完成
• 工具集成：自动工具发现与执行
• 可配置性：所有设置通过 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-min"