II Agent
用自带 API 密钥运行的自托管多模型智能代理，覆盖构建、研究与办公任务。
- Star 数
- ★ 3.4k
- 最近更新
- 2 个月前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 46/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 独立开发者想从简短提示起步制作移动应用或网站，并希望在本地运行完整前后端栈。
- 不适合
- 希望开箱即用、不想安装 Docker 与本地数据库的团队
- 依赖稳定外部 API 或 SDK 做二次开发的团队
- 源码审查
- 46/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
II Agent 是一个采用 Apache-2.0 许可证的开源 AI Agent，可由个人、研究团队和企业自行运行、分叉与扩展。它提供浏览器前端和后端服务，并以 PostgreSQL、Redis 与 MinIO 组成的本地服务栈运行。已文档化的功能包括从提示生成移动应用、网站、绘本和幻灯片，以及快速或多步骤研究。它还涵盖多模型对话、文件附件、代码解释器、文本文件搜索，以及 PDF、Excel、Word 和 PowerPoint 任务。部署后，后端默认运行于 localhost:8000，完整开发栈的前端默认运行于 localhost:1420。
先通过 make setup 创建 .env 文件并安装依赖，然后在 .env 的 MODEL_CONFIGS 中填写模型配置，或复制 model_configs.example.yaml 为 model_configs.yaml 并设置 MODEL_CONFIGS_FILE。make dev-all 会启动基础设施、后端和前端；文档列出的服务包括 PostgreSQL、Redis、MinIO、http://localhost:8000 的 Backend，以及 http://localhost:1420 的 Frontend。在运行中的产品中，用户可进行多模型对话、中途切换模型提供商、附加文件、使用代码解释器和文本文件搜索；也可发起快速研究或多步骤研究，并将研究简报生成带结构、视觉内容、引文和嵌入式问答的网站。README 还列出提示驱动的移动应用、网站、绘本、视频与图像生成，以及 PDF 提取与创建、Excel 公式与图表、Word 编辑和 PowerPoint 操作。
- 独立开发者想从简短提示起步制作移动应用或网站，并希望在本地运行完整前后端栈。
- 研究团队需要在快速研究与多步骤研究之间选择，并将研究简报交付为包含引文和嵌入式问答的交互式网站。
- 内部工具团队需要使用自有模型 API 密钥，并在同一系统中配置 OpenAI、Anthropic 或 Google 模型。
- 内容创作者希望从单个提示生成带插图的绘本，或在工作流中使用多个视频和图像模型。
- 处理办公文件的用户需要进行 PDF 提取与创建、Excel 公式和图表、Word 编辑或 PowerPoint 操作。
如何安装或部署这个 Agent？
前提条件：Docker、uv、Node.js 和 npm。执行：
git clone https://github.com/Intelligent-Internet/ii-agent.git- cd ii-agent
- make setup
- 在 .env 中设置至少一个模型提供商的 MODEL_CONFIGS，或将 model_configs.example.yaml 复制为 model_configs.yaml、填入 API 密钥，并在 .env 中设置 MODEL_CONFIGS_FILE=model_configs.yaml。
- 执行 make dev-all。
如何使用这个 Agent？
启动后访问 http://localhost:1420；后端地址为 http://localhost:8000。配置至少一个模型提供商及其 API 密钥后，可在聊天中使用文件附件、代码解释器或文本文件搜索，也可发起构建、研究和文档任务。若只需启动特定部分，可使用 make infra、make backend-dev 或 make frontend-dev；全容器部署可先创建并填写 docker/.stack.env，再执行 make stack。
这个 Agent 有哪些优点和局限？
- 自带 API 密钥（BYOK）配置可让部署者控制模型提供商与成本，并支持 OpenAI、Anthropic 和 Google 的模型配置。
- 提供本地开发栈和 Docker Compose 全栈路径，明确包含 PostgreSQL、Redis 与 S3 兼容的 MinIO。
- 同一产品文档覆盖应用生成、研究网站生成、文件处理和多模型对话，而不局限于单一工作流。
- 本地运行需要 Docker、uv、Node.js 与 npm，并需维护 PostgreSQL、Redis 和 MinIO 服务。
- 必须配置至少一个 LLM 提供商的 API 密钥；模型服务的可用性和费用由所选提供商决定。
- 所给材料虽列出 Gmail、Slack、GitHub、Notion、Google Calendar、Discord、Dropbox 和 Canva 等集成，但没有给出各集成的认证或配置步骤。
- 所给材料没有说明面向外部调用者的稳定 API、SDK 或版本兼容承诺。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| II Agent 当前 | 46 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.4k | 2 个月前 | Python | OpenAI API · Claude API |
| Loki Mode | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.1k | 1 天前 | Shell | Claude Code · Claude API |
| MS-Agent | 67 · 存在缺口 | 网页应用免费 + 模型费 | ★ 4.4k | 5 天前 | Python | — |
| Claude Code 技能与子代理集 | 66 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 1.7k | 3 天前 | Python | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
代码展示 API key 配置、认证模块、沙箱以及账单预留流程，但所给材料没有说明工具调用权限的最小化、破坏性操作确认、敏感数据生命周期或恢复机制。MCP 服务可从请求动态挂载配置并在 0.0.0.0 提供 HTTP 服务；材料未显示此路由的认证，因而数据流与外部影响说明有限。agent.py 标注改编自 Agno 并保留 Apache 许可说明，支持部分来源归属；但 docx 技能标为专有许可，与仓库 Apache 元数据存在范围不明的张力。
文档覆盖架构、启动流程和依赖配置，工具服务也有配置检查及部分错误响应；但 README 与开发指南所述目录、服务启动方式不完全一致，README 明示 MinIO 默认凭据。静态材料未证明依赖可用或版本兼容；错误处理有具体 HTTP 状态与消息，但启动连通性检查异常被忽略。
README列出开发者、研究团队及企业内部工具等目标场景，并覆盖研究、开发、文档和集成任务。技能文件以明确任务描述设触发条件，浏览器技能列出具体操作；但沙箱、工具和连接器的能力边界及不适用情形说明不足。安装说明支持 Docker 或本地开发及多种模型提供方，环境适配较广。
README、架构指南和快速查找文档提供导航、安装步骤、配置选项、命令和范例。仓库文档概述与开发指南的目录结构存在差异，命名约定也未在材料中统一说明。许可证文件为 Apache-2.0，但内含标注 Proprietary 的 docx 技能且其完整条款未提供，故无法确认所有产品内容的许可范围。材料没有清晰的版本发布或变更记录，也没有明确维护责任人；README 提供社区入口。
产品面向真实任务，列有聊天、研究、应用生成、媒体、文档及第三方集成能力；Agent 实现支持工具、子代理、事件和流式输出，具备可复用价值。但这些广泛能力意味着较重的基础设施、多个外部服务与凭据配置，材料没有给出典型部署成本或能力限制，成本收益依据偏薄。
README 的安装配置、AGENTS.md 的架构图、CLAUDE.md 的开发说明和代码中的 Agent、MCP 服务互相印证了框架包含服务端、工具、技能及外部集成。宣传性能力描述缺少所给材料中的逐项实现依据或量化结果；文档中将架构规则与产品能力并述，事实与推断区分有限。未将未执行测试视为扣分依据。
- MCP 示例路由接受请求配置并挂载外部服务器，且服务监听所有接口；材料没有展示该路由的认证或授权。部署前应确认网络边界和访问控制。
- README 展示 MinIO 默认账户密码；不要将示例凭据用于共享或生产环境。
- docx 技能标注 Proprietary，而仓库提供 Apache-2.0 许可证；材料未说明该技能的独立许可范围。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/ii-agent)<a href="https://followagents.com/zh/agents/ii-agent"><img src="https://followagents.com/badge/ii-agent.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
🚀 Big Release Alert: Full-Stack Web Agent Are Live! 🌐 We’re thrilled to announce a major milestone for the Intelligent Internet Agent project! Say hello to v0.4, packed with powerful new features, integrations, and real-world full-stack demos. This is our biggest release yet! --- 🔧 New Features – Full-Stack Web Agent Showcases Experience the magic of autonomous full-stack development: - 🌟 Live Showcases → [View on GitHub](https://github.com/Intelligent-Internet/ii-agent-community#) …在 GitHub 查看 ↗ -
发布说明摘录
Release v0.3 - Simplified Setup & Enhanced Experience We've made significant improvements to make ii-agent easier to set up and use, while adding powerful new features for a better AI agent experience. 🚀 Easier Setup - Streamlined Configuration: Simplified settings dialog with intuitive options that make initial setup much faster - Removed Complex Dependencies: Eliminated the need for Anthropic base URL configuration, reducing setup complexity - Better Default Settings: Intelligent defaults that work out of the box for most users ✨ Enhanced User Experience …在 GitHub 查看 ↗ -
发布说明摘录
🛠 ii-agent v0.2 Release Notes We’re excited to announce the v0.2 release of the ii-agent! This update brings major feature upgrades, critical bug fixes, improved tooling, and support for more powerful LLM backends such as Gemini-2.5-pro. Here's what’s new: 🚀 What's Changed ✨ New Features - Prompt Enhancements & User Controls - Improved prompt generation logic and message handling. - Users can now cancel or edit prompts during interactions. - Tooling Enhancements - Introduced Message Tool and Return Control Tool for better user-agent interaction. …在 GitHub 查看 ↗
常见问题
是否必须使用某一家模型厂商？
运行前需要什么凭据？
完整开发环境会启动哪些服务？
可以只启动部分服务吗？
谢谢反馈，我们会据此改进页面。