ii-agent

环境要求

• Git（用于克隆仓库）
• 本地运行方式需要 Python 与 Node.js 环境
• Docker 与 Docker Compose（全栈容器方式，无需本地 Python/Node）
• GNU Make（README 使用 make 命令）
• 自备 LLM 提供商的 API Key（BYOK）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 ii-agent 源码并进入项目目录，后续所有命令都在该目录执行。

   git clone https://github.com/Intelligent-Internet/ii-agent.git
   cd ii-agent

   复制

2. 2执行首次初始化

   运行 make setup，自动生成 .env 配置文件并安装依赖，README 中标注为第一次运行的初始化步骤。

   make setup

   复制

3. 3填写后端配置

   编辑 .env（由 .env.example 生成），填入数据库、Redis、存储、鉴权以及 LLM 密钥等后端配置。

4. 4填写前端配置

   编辑 frontend/.env（由 frontend/.env.example 生成），配置 API URL、Google OAuth 与主题。

5. 5配置模型定义

   如不使用 .env 中的内联 JSON，可将 model_configs.example.yaml 复制为 model_configs.yaml 来定义 LLM 模型。

   cp model_configs.example.yaml model_configs.yaml

   复制

6. 6准备 Docker 环境变量

   编辑 docker/.stack.env，填入自己的凭据，这是 Docker Compose 全栈启动前必须完成的一步。

7. 7启动全栈服务

   执行 make stack 启动完整服务；改动镜像后可用 make stack-build 带 --build 重新构建并启动。

   make stack

   复制

8. 8查看与停止服务

   用 make stack-logs 跟踪全部日志排查问题，用 make stack-down 停止并清理容器。

   make stack-logs

   复制

关键配置

如何确认成功

执行 make stack-logs 查看全部服务日志，容器正常启动且日志无报错即成功。

常见问题

注意事项

• 配置项的具体键名与取值需参考 .env.example、frontend/.env.example 等示例文件，README 未逐一列出。
• LLM 密钥等敏感信息请勿提交到版本库。
• 项目采用 Apache-2.0 许可，可自由运行、fork 和扩展。
• 官网提供在线 Web 应用，也可先试用再决定本地部署。