🇨🇳中文 | 🌐English | 🇯🇵日本語
<div align="center" <a href="https://github.com/shibing624/agentica" <img src="https://raw.githubusercontent.com/shibing624/agentica/main/docs/assets/logo.png" height="150" alt="Logo" </a </div
-----------------
Agentica
让 Agent 真正跑起来——跑得久、不跑飞、能干活、会进化。 Async-first Python agent harness · 40+ 工具 · 20+ 模型 · MCP · CLI + Web Gateway
Agentica 不是套一层 LLM API 的聊天壳，而是一个 Async-First 的 agent harness——让 Agent 真正跑起来：调工具、跑长任务、多智能体协作、跨会话记忆，并持续自我进化。
| | | |------|------| | 跑得久，不跑飞 | 专门 Agentic loop 驱动的 LLM ↔ Tool 长循环，内置上下文压缩、成本预算、死循环防护，长任务不断链 | | 能干活，不只聊天 | 文件、执行、搜索、浏览器、MCP、多智能体、Workflow——真实动手，不绑定单一 IDE | | 记得住，会遗忘 | 记忆按条目存储、相关性召回、drift 防御，确认过的偏好同步到全局 ~/.agentica/AGENTS.md | | 越用越强 | 工具失败 / 用户纠正 / 成功序列沉淀为经验卡片，自动编译成可复用的 SKILL.md，跨会话生效 | | 全可换，不锁死 | 模型、工具、记忆、Skill、Guardrails、MCP 都是可替换部件，而非封闭 SaaS 黑盒 |
和其它框架对比
| | Agentica | LangChain | AutoGen / CrewAI | Pydantic AI | |---|---|---|---|---| | Async-first agentic loop | ✅ 内置压缩/预算/防死循环 | 片段拼装 | ✅ | ✅ | | 自进化 Skill | ✅ 自动编译 SKILL.md | ❌ | ❌ | ❌ | | /goal 长任务循环 | ✅ | ❌ | ❌ | ❌ | | 持久跨会话记忆 | ✅ 开箱即用 | 需自行拼装 | 部分 | 需自行拼装 | | 开箱 CLI + Web Gateway | ✅ | ❌ | ❌ | ❌ |
🔥 News
- [2026/07/24] v1.4.10：支持视觉模型原生图片输入与模型能力 catalog 路由；新增 /rename 和按名称 /resume。详见 Release-v1.4.10
- [2026/07/21] v1.4.9：内置 subagent 全部改为只读；editfile 改为 tip 提示而非硬拒；修复 askuserquestion CLI 卡死。详见 Release-v1.4.9
- [2026/07/05] v1.4.7：CLI 新增 cron 运行时（/cron 命令 + daemon）、自管理（/upgrade、/config set|env）；统一配置到 ~/.agentica/config.yaml。详见 Release-v1.4.7
- [2026/06/03] v1.4.6：支持fallback模型可配置，支持多个fallback模型；支持 LSP， CLI 开启 LSP 开关（--enable-diagnostics/--diagnostics-server）；支持 agentica doctor；支持 /goal 长程任务。详见 Release-v1.4.6
- [2026/05/11] v1.4.4：MemoryExtractHooks 优化，新增 autoextractmemorybackground 后台抽取（不再阻塞 onagentend），memory 抽取优先走更快更便宜的 auxiliarymodel。详见 Release-v1.4.4
- [2026/05/10] v1.4.3：Skill 生命周期重构 + VaG 解耦，新增 SkillLifecycleHooks 统一扩展点。详见 Release-v1.4.3
架构
Agentica 提供了从底层模型路由到顶层多智能体协作的完整抽象：
<div align="center" <img src="https://raw.githubusercontent.com/shibing624/agentica/main/docs/assets/architecturev2.jpg" width="800" alt="Agentica Architecture" / </div
核心执行引擎 (Agentic Loop)
Agentica 的单体 Agent 运行在一个纯粹的基于控制流的 while(true) 引擎中，严格依据工具调用来驱动，并内置了防死循环、成本追踪、上下文微压缩（Compaction）和四层安全护栏：
<div align="center" <img src="https://raw.githubusercontent.com/shibing624/agentica/main/docs/assets/agentloop.png" width="800" alt="Agentica Loop Architecture" / </div