I
Intelligent-Internet/ii-agent
II-Agent: a new open-source framework to build and deploy intelligent agents
agentagentic-aiaiai-agentai-agent-frameworkllmmanus
PythonApache-2.0创建于 2025/4/7更新于 昨天
README
由 Gemini 翻译整理
II Agent
II-Agent 是一个专为实际工作构建的开源 AI Agent，现已结束测试阶段。本项目基于 Apache-2.0 许可证完全开源。
无论你是独立开发者、研究团队，还是构建内部工具的企业，都可以运行、复刻（fork）并扩展它。没有黑盒，没有厂商锁定。你可以自带 API Key (BYOK)，完全掌控成本和模型供应商。
简介
https://github.com/user-attachments/assets/430425c4-2352-4101-9fdb-46bdfc63d26a
核心功能
构建 (Build)
- 移动应用开发 — 从简短的提示词（Prompt）生成完整的移动应用程序
- 网站应用开发 — 从简短的提示词生成完整的网站应用程序
- 故事书生成 — 根据单一提示词创作图文并茂的绘本
- 视频与图像生成 — 在同一个工作流中支持多种模型
- 实时编辑 — 对网站、幻灯片和故事书进行实时在线编辑
- 计划模式 (Plan Mode) — 在构建前进行可视化项目规划
研究 (Research)
- 快速研究与深度研究 — 获取即时答案或进行多步骤调查
- 交互式网站生成 — 将研究摘要转化为包含结构、视觉效果、引文和嵌入式问答的完整网站
自动化与集成 (Automate & Integrate)
- 内置与自定义技能 — 复用工作流并连接基于 GitHub 的流程
- 应用集成 — 支持 Gmail、Slack、GitHub、Notion、Google Calendar、Discord、Dropbox、Canva 等
- 更快的执行速度 — 相比早期的 beta 版本，执行速度显著提升
其他功能
| 领域 | 功能 |
|---|---|
| 聊天 | 多模型对话（可在会话中切换供应商）、文件附件、代码解释器、文本文件搜索 |
| Agent | 具备多步骤任务规划的通用任务处理 |
| 文档 | PDF 提取与创建、Excel 公式与图表、Word 编辑、PowerPoint 操作 |
| 幻灯片 | 通过提示词创建演示文稿，支持实时协作编辑和模板 |
安装指南
先决条件
- Docker — 安装 Docker
- uv —
curl -LsSf https://astral.sh/uv/install.sh | sh - Node.js & npm — 安装 Node.js (或使用 nvm)
快速开始
# 1. 克隆仓库
git clone https://github.com/Intelligent-Internet/ii-agent.git
cd ii-agent
# 2. 运行首次设置（创建 .env 文件并安装依赖）
make setup
# 3. 配置你的 LLM API Key
# 编辑 .env 文件并至少设置一个 LLM 供应商：
# 选项 A：在 .env 中直接以 JSON 格式配置
# MODEL_CONFIGS='[{"model_id":"claude-sonnet-4-6","provider":"Anthropic","api_key":"sk-ant-...","display_name":"Claude Sonnet 4","is_default":true}]'
# 选项 B：使用 YAML 配置文件
# 将 model_configs.example.yaml 复制为 model_configs.yaml，填入你的 Key，
# 然后在 .env 中设置 MODEL_CONFIGS_FILE=model_configs.yaml
# 4. 启动所有服务（基础设施 + 后端 + 前端）
make dev-all
这将启动：
- 后端：http://localhost:8000
- 前端：http://localhost:1420
- PostgreSQL：localhost:5432
- Redis：localhost:6379
- MinIO (S3 兼容存储)：http://localhost:9001 (用户名/密码: minioadmin/minioadmin)
配置文件
| 文件 | 源自 | 用途 |
|---|---|---|
.env | .env.example | 后端配置：数据库、Redis、存储、认证、LLM Key |
frontend/.env | frontend/.env.example | 前端配置：API URL、Google OAuth、主题 |
model_configs.yaml | model_configs.example.yaml | LLM 模型定义（替代 .env 中的内联 JSON） |
LLM 供应商
II-Agent 支持多种 LLM 供应商。请在 model_configs.yaml 或通过 .env 中的 MODEL_CONFIGS 进行配置：
| 供应商 | model_id 示例 | 备注 |
|---|---|---|
| OpenAI | gpt-5.4 | 需要 api_key |
| Anthropic | claude-opus-4-6 | 支持直接 API 或 Vertex AI |
gemini-3.1-pro-preview | 支持直接 API 或 Vertex AI |
查看 model_configs.example.yaml 以获取包括 Vertex AI、Azure 和自托管模型在内的完整配置选项。
有用的 Make 命令
make help # 显示所有可用命令
make dev-all # 启动所有服务（基础设施 + 后端 + 前端）