Agentao：面向 Python 的本地优先可治理 AI Agent 运行时

核心能力与快速开始

★ 307 · Python

能做什么

提供受治理的 Agent 运行时：工具确认与四种权限模式（read-only / workspace-write / full-access / plan）、规划模式、macOS sandbox-exec；通过 MCP（stdio/Streamable HTTP/SSE）与 ACP（stdio JSON-RPC）连接外部工具与代理，支持插件与 hooks；SQLite 持久记忆（用户/项目两种作用域、自动召回、jieba 中文分词）；技能自发现与 GitHub 安装、/crystallize 工作流；内置 codebase-investigator 与 generalist 子代理及自定义 .agentao/agents/<name>.md；token 跟踪、LLM 摘要压缩、溢出恢复与文件再注入；JSONL 会话回放、流式思考与工具输出展示、完整 LLM 日志；支持通过 OpenAI 兼容接口及 Anthropic Messages、OpenAI Responses 原生格式接入多种模型提供方；可作为 Python 库（Agentao 构造函数、events() 流、active_permissions()）嵌入宿主应用。

适用场景

将 Agent 能力嵌入 Python 应用并保持宿主对输入与权限的控制；在终端以 CLI 进行交互式或非交互式（agentao -p）Agent 任务；通过 MCP/ACP 对接外部工具与其他代理；为编码代理（如 Claude Code、Codex）提供集成模板；构建带权限约束、持久记忆、可回放审计的多会话 Agent 应用。

项目形态

开发框架

部署方式

支持 pip 安装后作为 Python 库嵌入（pip install agentao）、作为 CLI 运行（pip install 'agentao[cli]'）或作为 ACP 服务器运行；文档称本地优先、无数据库与云依赖，具体生产部署条件未说明。

主要依赖

Python 3.10+；启动需设置 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL；其他提供方需设置 <NAME>_API_KEY、<NAME>_BASE_URL、<NAME>_MODEL 并通过 LLM_PROVIDER 选择；具体硬件与 API 成本未说明。

使用限制

README 未说明性能、并发规模与安全边界；API 成本、速率限制与商用授权范围未说明；部分能力（如 macOS sandbox-exec、Playwright 渲染）依赖特定环境或可选依赖。

许可证

MIT

最近推送

2026-10-09 00:01

资料检查：2026-10-09 07:00 · 卡片整理：2026-10-09 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

将 Agentao 作为库嵌入 Python 宿主应用，构建本地优先、可治理的 AI Agent，用于代码相关任务；通过权限模式、工具确认、MCP/ACP 协议、SQLite 持久记忆、技能插件、子代理和 JSONL 会话回放等能力支持开发与排错工作。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证