II-Agent 是一款为实际工作打造的开源 AI 助手，现已正式推出，不再处于测试阶段。完全开源，采用 Apache-2.0 许可证。

无论您是独立开发者、研究团队，还是正在构建内部工具的企业——都可以运行、分叉并扩展它。没有黑盒，没有供应商锁定。您可以使用自己的 API 密钥（BYOK），完全掌控成本和模型提供商的选择。

试用网页应用 | 加入我们的 Discord

简介

https://github.com/user-attachments/assets/430425c4-2352-4101-9fdb-46bdfc63d26a

核心功能

构建

• 移动应用开发 — 从简短提示快速生成完整的移动应用
• 网站应用开发 — 从简短提示快速生成完整的网站应用
• 故事书生成 — 仅凭一个提示即可创建配有插图的完整绘本
• 视频与图像生成 — 在同一工作流中支持多种模型
• 实时编辑 — 支持网站、幻灯片和故事书的实时编辑
• 计划模式 — 在开始构建前进行可视化项目规划

研究

• 快速研究与深度研究 — 提供快速解答或多步骤调查
• 交互式网站生成 — 将研究简报转化为包含结构、视觉内容、引用和嵌入式问答的完整网站

自动化与集成

• 内置与自定义技能 — 可重用工作流程，并连接基于 GitHub 的流程
• 应用集成 — Gmail、Slack、GitHub、Notion、Google 日历、Discord、Dropbox、Canva 等
• 更快的执行速度 — 相较于早期测试版本，速度显著提升

其他功能

领域	功能
聊天	多模型对话（可在同一线程中切换提供商）、文件附件、代码解释器、文本文件搜索
代理	执行包含多步任务规划的通用任务
文档	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 密钥
#    编辑 .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，填入您的密钥，
#    然后在 .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 密钥
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
Google	gemini-3.1-pro-preview	可直接使用 API 或 Vertex AI

请参阅 model_configs.example.yaml，了解包括 Vertex AI、Azure 以及自托管模型在内的完整配置选项。

常用 Make 命令

make help             # 显示所有可用命令
make dev-all          # 启动所有服务（基础设施 + 后端 + 前端）
make infra            # 仅启动 Postgres、Redis、MinIO
make backend-dev      # 仅启动后端（端口 8000）
make frontend-dev     # 仅启动前端（端口 5173）
make db-migrate       # 运行数据库迁移
make lint             # 检查后端和前端代码
make format           # 自动格式化后端和前端代码
make test             # 运行所有测试
make stack            # 使用 Docker Compose 启动完整堆栈

Docker Compose（完整堆栈）

若想在 Docker 中运行所有服务（无需本地 Python/Node）：

# 复制并编辑堆栈环境文件
cp docker/.stack.env.example docker/.stack.env
# 根据您的凭证编辑 docker/.stack.env

make stack            # 启动完整堆栈
make stack-build      # 带 --build 参数启动（重新构建镜像）
make stack-down       # 停止并清理
make stack-logs       # 查看所有日志

更多资源

如需更多详细信息，请参阅我们的官方指南

https://github.com/user-attachments/assets/d1fa7cde-06cc-4103-bed0-d4ad5e640de4

II-Agent 快速上手指南

II-Agent 是一款开源 AI 智能体，专为实际工作场景设计。它支持从移动端/网页应用开发、绘本生成到深度研究等多种任务，完全开源（Apache 2.0 协议），无厂商锁定，支持自带 API Key (BYOK)。

环境准备

在开始之前，请确保您的系统已安装以下依赖：

• Docker: 安装 Docker
  • 国内用户建议: 若拉取镜像困难，请配置 Docker 国内镜像加速器。
• uv (Python 包管理工具):

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  • 国内用户建议: 若上述脚本访问慢，可尝试通过 pip install uv 安装（需先安装 Python pip）。
• 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. 配置大模型 API Key

编辑根目录下的 .env 文件，配置至少一个大模型提供商。您有两种方式：

方式 A：直接在 .env 中配置 (JSON 格式) 找到 MODEL_CONFIGS 变量，填入您的密钥：

MODEL_CONFIGS='[{"model_id":"claude-sonnet-4-6","provider":"Anthropic","api_key":"sk-ant-...","display_name":"Claude Sonnet 4","is_default":true}]'

方式 B：使用 YAML 配置文件 (推荐)

1. 复制示例文件：

   cp model_configs.example.yaml model_configs.yaml
   

2. 编辑 model_configs.yaml，填入您的 API Key 和模型信息。
3. 在 .env 文件中设置：

   MODEL_CONFIGS_FILE=model_configs.yaml
   

注意：支持 OpenAI, Anthropic, Google (Vertex AI) 等多种提供商。详细配置请参考 model_configs.example.yaml。

4. 启动服务

运行以下命令启动基础设施、后端和前端：

make dev-all

启动成功后，您将拥有以下服务：

• 前端界面: http://localhost:1420
• 后端 API: http://localhost:8000
• 数据库 (PostgreSQL): localhost:5432
• 缓存 (Redis): localhost:6379
• 对象存储 (MinIO): http://localhost:9001 (账号/密码: minioadmin/minioadmin)

(可选) 纯 Docker 模式: 若不想在本地安装 Python/Node，可配置 docker/.stack.env 后运行 make stack。

基本使用

1. 访问界面：打开浏览器访问 http://localhost:1420。
2. 创建任务：
   • 开发应用：输入提示词如“创建一个待办事项移动应用”，II-Agent 将自动规划并生成完整代码。
   • 生成绘本：输入“写一个关于太空探险的儿童故事并配图”，系统将生成图文结合的 Storybook。
   • 深度研究：输入研究主题，选择"Deep Research"模式，Agent 将进行多步调查并生成带引用的报告网站。
3. 实时协作：在生成的网页、幻灯片或故事中，您可以直接使用内置编辑器进行实时修改和调整。
4. 集成扩展：在设置中连接 Gmail、Slack、GitHub 等账户，让 Agent 自动执行跨应用工作流。

常用管理命令

make help             # 查看所有可用命令
make backend-dev      # 仅启动后端
make frontend-dev     # 仅启动前端
make db-migrate       # 运行数据库迁移
make stack-down       # 停止并清理所有 Docker 容器