Intelligent-Internet/ii-agent
GitHub: Intelligent-Internet/ii-agent
一款开源、支持自带密钥的智能体框架,致力于帮助用户构建和部署可自主掌控的 AI Agent,涵盖应用生成、研究调查、文档处理与第三方集成等场景。
Stars: 3349 | Forks: 512

# II Agent
II-Agent 是一款专为实际工作而构建的开源 AI Agent——现已正式推出。采用 Apache-2.0 许可协议,100% 开源。
无论您是独立开发者、研究团队,还是正在构建内部工具的企业——您都可以运行、fork 并扩展它。没有黑盒,没有供应商锁定。自带 API 密钥 (BYOK),全面掌控成本和模型提供商。
## 介绍
https://github.com/user-attachments/assets/430425c4-2352-4101-9fdb-46bdfc63d26a
## 核心功能
### 构建
* **移动应用开发** — 从简短的提示词生成完整的移动应用程序
* **网站应用开发** — 从简短的提示词生成完整的网站应用程序
* **故事书生成** — 仅凭单个提示词即可创建带完整插图的故事书
* **视频和图像生成** — 在单一工作流中支持多种模型
* **实时编辑** — 支持对网站、幻灯片和故事书进行实时编辑
* **计划模式** — 在构建之前进行可视化项目规划
### 研究
* **快速研究与深度研究** — 提供快速解答或多步骤的深入调查
* **交互式网站生成** — 将研究简报转化为包含结构、视觉元素、引文和嵌入式问答的完整网站
### 自动化与集成
* **内置与自定义技能** — 复用工作流并连接基于 GitHub 的流程
* **应用集成** — Gmail, Slack, GitHub, Notion, Google Calendar, Discord, Dropbox, Canva 等
* **更快的执行速度** — 与早期的 beta 版本相比,速度得到显著提升
### 其他功能
| 领域 | 功能 |
| :--- | :--- |
| **聊天** | 多模型对话(可在对话中途切换提供商)、文件附件、代码解释器、文本文件搜索 |
| **Agent** | 具备多步骤任务规划的通用任务处理 |
| **文档** | PDF 提取与创建、Excel 公式和图表、Word 编辑、PowerPoint 操作 |
| **幻灯片** | 提示词生成幻灯片,支持实时协作编辑和模板 |
## 安装说明
### 前置条件
- **Docker** — [安装 Docker](https://docs.docker.com/get-docker/)
- **uv** — `curl -LsSf https://astral.sh/uv/install.sh | sh`
- **Node.js & npm** — [安装 Node.js](https://nodejs.org/)(或使用 nvm)
### 快速开始
```
# 1. Clone the repository
git clone https://github.com/Intelligent-Internet/ii-agent.git
cd ii-agent
# 2. 运行首次设置(创建 .env 文件 + 安装 deps)
make setup
# 3. 配置你的 LLM API keys
# 编辑 .env 并设置至少一个 LLM provider:
# 选项 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 config file
# 将 model_configs.example.yaml 复制到 model_configs.yaml,填入你的 keys,
# 然后在 .env 中设置 MODEL_CONFIGS_FILE=model_configs.yaml
# 4. 启动一切(infra + backend + frontend)
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 |
有关完整的配置选项(包括 Vertex AI、Azure 和自托管模型),请参阅 [`model_configs.example.yaml`](model_configs.example.yaml)。
### 常用 Make 命令
```
make help # Show all available commands
make dev-all # Start everything (infra + backend + frontend)
make infra # Start only Postgres, Redis, MinIO
make backend-dev # Start backend only (port 8000)
make frontend-dev # Start frontend only (port 5173)
make db-migrate # Run database migrations
make lint # Lint backend + frontend
make format # Auto-format backend + frontend
make test # Run all tests
make stack # Start full stack via Docker Compose
```
### Docker Compose(完整技术栈)
要在 Docker 中运行所有内容(无需本地安装 Python/Node):
```
# 复制并编辑 stack env 文件
cp docker/.stack.env.example docker/.stack.env
# 编辑 docker/.stack.env 填入你的 credentials
make stack # Start full stack
make stack-build # Start with --build (rebuild images)
make stack-down # Stop and clean up
make stack-logs # Tail all logs
```
### 其他资源
有关更多详细信息,请参阅我们的[官方指南](https://intelligent-internet.github.io/ii-agent-prod/)
https://github.com/user-attachments/assets/d1fa7cde-06cc-4103-bed0-d4ad5e640de4
标签:AI智能体, MITM代理, 人工智能, 应用开发, 搜索引擎查询, 暗色界面, 测试用例, 用户模式Hook绕过, 研究工具, 请求拦截, 逆向工具