Agent-2

Agent-2 是一款自托管自主型 AI Agent，基于 Google Gemini 多模型打造，集编码助手、终端 Agent、安全测试和持久记忆于一身，在单一 SQLite 数据库文件中保存全部状态，无需账号、无遥测数据、无构建步骤，开箱即用。 产品简介 Agent-2 由独立开发者 Aarav Shah 创建，GitHub 获星 90 颗，2026 年 9 月 4 日更新，定位为隐私优先的本地 AI 编码工作站。产品支持三大入口（CLI、Web UI、Dual 双模式），共享同一套系统提示词、工具调度器、记忆与规则表、差异引擎、命令看门狗、模型路由器和数据库，实现真正的"三端一体"架构。 核心功能 三大入口无缝切换：CLI 模式（agent2cli.py）提供富文本终端界面，含内联差异对比、全屏差异查看器和实时命令看门狗；Web UI 模式（agent2web.py）通过 Flask + Socket.IO 在 http://localhost:1311 提供流式工具调用、多标签页终端和记忆/规则/密钥/MCP 管理面板；Dual 模式将 Web 服务器置于后台线程，CLI 置于前台，单一进程共享同一份 agent2.db。 17 种 Agent 工具：核心工具集包含 12 个（run_command、read_file、write_file、multi_edit_files、list_dir、grep_search、delete_file、scan_project、web_search、update_todo、save_memory、emit_plan），文件智能工具集包含 5 个（detect_file、file_capabilities、run_file_op、convert_file、search_workspace），所有工具均通过统一路由器分发。 Gemini 多模型路由：内置模型路由器（llm/router.rank_candidates()），支持 Gemini 全系 6 个模型变体，自动根据任务复杂度选择合适模型，也可手动指定。 MCP 服务器集成：内置 MCP 服务器注册表（integrations/registry.py），支持扩展第三方工具和外部服务集成。 持久化记忆与规则：SQLite 单文件状态存储（agent2.db），支持记忆写入和规则持久化，跨会话保持上下文连贯性。 API 密钥轮换：内置密钥轮换机制（llm.keys.rotator），支持多 Gemini API 密钥管理，自动处理限额和失效切换。 Docker 一键部署：通过 python run.py --docker 启动容器化运行，提供 stop、restart、logs、status、update、uninstall 等子命令全局 agent2 命令。 特色优势 完全自托管：所有数据存储在本地（agent2.db），不向任何第三方服务发送遥测数据，适合对数据隐私有严格要求的用户。 零配置启动：run.py 是唯一启动器也是包清单，依赖表集中于此，首次运行自动创建虚拟环境、装依赖并引导用户输入 Gemini API 密钥，无需手动配置环境变量。 单事实源原则：代码库强制"每个事实只有一个归属"规则，防止多副本导致的静默漂移，确保三端行为一致性。 架构纯净：Python 3.9+，Flask Web 框架，无重型依赖，安装包体积极小，适合在资源受限环境运行。 测试覆盖率 1602：项目包含完整的 pytest 测试套件，声称 1602 个测试用例覆盖核心逻辑，保证更新迭代不破坏已有功能。 应用场景 本地隐私编码：开发者不希望将代码发送至第三方 API，Agent-2 可完全在本地运行，所有交互数据不离开本机。 Gemini 深度定制：需要利用 Gemini 多模态能力（代码生成、推理、安全测试）进行复杂任务的开发者，可通过 Agent-2 的工具调度框架灵活编排。 自动化脚本执行：借助 run_command 和 file intel 工具集，可构建复杂的自动化脚本，执行文件批处理、项目扫描、安全检测等任务。 多端协作开发：CLI 和 Web UI 可同时运行，团队成员在终端操作的同时，其他人通过浏览器远程监控和干预会话状态。 适用人群 具备基本 Python 环境的技术用户，尤其是对 AI 编码工具有隐私要求（不希望代码上传云端）的开发者、Gemini 重度用户，以及希望构建完全本地化 AI 编码工作流的独立开发者和技术团队。产品定位偏向中高级用户，需理解 Agent 工具链和 API 密钥管理概念。 出品方与更新动态 出品方为独立开发者 Aarav Shah（GitHub：aaravshah1311），采用 MIT 许可证开源。仓库保持高频更新（最新更新 2026 年 9 月 7 日），文档完善，包含完整架构说明、安全态势说明和测试指南。 官网链接 官网：http://agent2.is-best.net GitHub 仓库：https://github.com/aaravshah1311/Agent-2