ii-agent
Intelligent-Internet/ii-agent加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象这样一个下午：产品经理丢下一句话"做一个带用户登录的儿童绘本阅读 App"，要求两小时内能演示。传统做法是拉一个开发排期、画原型、等联调；而 II-Agent 想做的是把它压缩成一次对话——你在网页端敲下那句话，Agent 自己在沙箱容器里生成前端代码、插图、配音，最后交付一个可运行的完整应用。这不是概念演示，II-Agent 已于 2025 年 4 月开源、2026 年 11 月仍是 GitHub 上增长最快的智能体框架之一（3391★ / 525 fork / 7 位贡献者）。
II-Agent 来自 Intelligent-Internet 团队，是"更广泛的智能互联网"战略中的一块拼图——官方博客直言其目标是"把数据集、模型、智能体、群体与系统全部开放"，以对抗闭源 SaaS 的黑箱。团队公开了 GAIA 基准成绩（官方站点 ii-agent-gaia.ii.inc），并罕见地同时发布了两份"自曝短板"文档：一份列举 GAIA 数据集本身的标注错误，一份记录自家框架的基准缺陷。这种透明度在 2025 年的 agent 项目里相当罕见，也解释了它为什么能同时吸引 Vinay Kumar 式的工程团队与 Chip Huyen 这类研究者关注。
如果把 II-Agent 想象成一个"开源版 Total Commander 加 AI 秘书"：总控台负责拆解任务，仓库里躺着几十个专职工具箱（浏览器自动化、代码解释器、PDF 解析、PPT 生成、Gmail/Slack/Notion 连接器），而真正干活的是你自带的模型——就像给秘书配了钥匙而不是把秘书关进黑盒。区别于 Manus 那类闭源产品，II-Agent 的每个环节都能拆开看、换掉、改写。
技术栈上，后端 Python + FastAPI + SQLAlchemy/Alembic，核心 Agent 逻辑集中在 src/ii_agent/agents/agent.py（约 16 万字符）、配套 connector/factory/hooks/skills/sandboxes/tools 等分层目录；工具层 src/ii_agent_tools 单独拆出 integrations/llm/storage/client；基础设施 Postgres 15 + Redis 7 + MinIO 用作对象存储，Redis 承载会话，sandbox 以独立容器承载代码执行，并预置 Codex 与 Claude 沙箱模板。前端是 React + TypeScript + Vite，经 python-socketio / WebSocket 与后端做实时事件推送，另有 Rust 写的 src-tauri 桌面壳。
门槛不在代码，而在依赖密度。官方路径是 git clone → make setup（生成 .env、装 uv 依赖与前端 npm 依赖）→ 填 LLM 密钥 → make dev-all。想彻底 Docker 化可用 make stack（docker-compose.stack.yaml 一次拉起 backend/frontend/postgres/redis/minio，端口 8000/1420/5432/6379/9000）。后端 Dockerfile 依赖面较宽：apt 装入 ffmpeg、nodejs、npm、ruby-full、build-essential，还额外 gem install fastlane 用于 iOS 签名，镜像体积和构建时间都不小。Python 侧 130 余个依赖（anthropic、openai、google-genai、google-cloud-aiplatform、playwright、e2b-code-interpreter、fastmcp、transformers、weasyprint…）意味着首次安装时间偏长。真实门槛还包括：至少一个可用的 LLM API Key、OAuth/Stripe 等可选集成配置、以及对 Postgres/Redis/MinIO 三件套的运维熟悉度。
第一，成本不可控：BYOK 意味着 token 账单直接落在使用者头上，多模型编排与 Deep Research 这类长链路任务很容易烧钱，官方没有给出成本护栏机制。第二，安全面偏大：sandbox 虽做了容器隔离，但项目内置了 Claude/Codex 沙箱模板与 SSH 挂载方案，且 compose 默认沿用 postgres/postgres、minioadmin/minioadmin 等弱口令，生产环境必须逐项替换。第三，代码健康度不均衡：仓库有 ruff、mypy、pre-commit，src/tests 下分了 unit/integration/smoke 三层，但主 Agent 文件已达 16 万字符，属于明显的单文件膨胀，可维护性存疑。第四，项目尚未提供覆盖率数据或 CI 徽章，测试质量只能从目录结构推断。第五，中文资料以英文为主，官方 guide 与社区中文教程稀缺。
II-Agent 的真正价值不是"又一个 agent 框架"，而是把闭源产品里最不透明的那层——任务如何被拆解、工具如何被调度、过程如何被回放——完整摊开在 Apache-2.0 协议下，让企业可以在自己的 VPC 里改造它。对于需要自建内部工具平台的团队，它提供了一份相当完整的参考实现：多模型抽象、技能系统、工具连接器、沙箱隔离、实时事件流一应俱全。
2025 到 2026 年，agent 框架赛道经历了从"性能竞赛"到"可控性竞赛"的转向：Manus 用闭源体验定义上限，OpenAI 用 API 定义可达性，而 II-Agent 选择了第三条路——把上限与可达性都做成可审计、可二开的代码。随着 3391 star、525 fork 和 Apache-2.0 协议带来的商用友好度，它正成为"私有化部署 agent 平台"这条路线上被讨论最多的开源选项之一。可以预期的是，随着其与 II-Researcher、模型与数据集体系的陆续开放开源，智能体基础设施的竞争将从"谁更聪明"转向"谁更透明"。
图：II-Agent 仓库 assets 目录中的项目图标
图：仓库 assets 目录中的 GAIA 基准测试配图
图：frontend 目录下打包进应用的 logo 资源