当前 v2 为不稳定 alpha 版,会有破坏性变更,不建议用于生产;需先安装 uv 工具链;默认服务端口为 1865
uv init --bare
uv add cheshire-cat-ai
uv run ccatREADME 未说明
一个自底向上设计、便于理解和扩展的 AI agent 微服务框架,适合教学与研究
开箱即用的 AI Agent 微服务,用 Docker 一键部署,内置对话、函数调用和 MCP 客户端,帮你快速搭出可扩展的智能助手后端。
核心能力
- 以微服务形式提供 AI agent,并自带 Web UI 与 REST API 调试页
- 自底向上设计,代码易于理解和扩展
- 支持通过 vibe coding 或 agentic engineering 方式扩展
- 面向教育与研究,可用于在 Web 上发布 agent
容易踩的坑
- 2.0.23最新正式版2026-07-08 · 2026-07-08 16:13 UTC
Full Changelog: https://github.com/cheshire-cat-ai/core/compare/2.0.22...2.0.23
- 2.0.222026-07-04 · 2026-07-04 11:35 UTC
查看更新说明
What's Changed
- fix: load bundled plugins on Windows by @davidegavio in https://github.com/cheshire-cat-ai/core/pull/1133
Full Changelog: https://github.com/cheshire-cat-ai/core/compare/2.0.21...2.0.22
- 2.0.212026-06-22 · 2026-06-22 16:07 UTC
查看更新说明
Full Changelog: https://github.com/cheshire-cat-ai/core/compare/2.0.20...2.0.21
- 2.0.202026-06-22 · 2026-06-22 12:54 UTC
查看更新说明
Full Changelog: https://github.com/cheshire-cat-ai/core/compare/2.0.19...2.0.20
- 2.0.192026-06-21 · 2026-06-21 09:23 UTC
查看更新说明
What's Changed
- Update startup.py by @BDadmehr0 in https://github.com/cheshire-cat-ai/core/pull/1051
- classify score_threshold as parameter, default 0.5, instead of magic … by @primax79 in https://github.com/cheshire-cat-ai/core/pull/1057
- Dev/qdrant update by @nickprock in https://github.com/cheshire-cat-ai/core/pull/1059
- Added CCAT_QDRANT_CLIENT_TIMEOUT environment parameter to configure Q… by @primax79 in https://github.com/cheshire-cat-ai/core/pull/1061
- Improve Qdrant collection management with safer alias handling and errors handligs by @primax79 in https://github.com/cheshire-cat-ai/core/pull/1062
- Improves plugin validation and handles duplicates by @primax79 in https://github.com/cheshire-cat-ai/core/pull/1068
- Fix escape characters in utils.parse_json by @davidebizzocchi in https://github.com/cheshire-cat-ai/core/pull/1070
- Levenshtein distance without langchain by @Pingdred in https://github.com/cheshire-cat-ai/core/pull/1072
- Use official langchain cohere by @Pingdred in https://github.com/cheshire-cat-ai/core/pull/1073
- Fix for cleared chat history reloaded by stateful cache managers by @lucapiccinelli in https://github.com/cheshire-cat-ai/core/pull/1076
- Decouple MCP types from Cat chat types by @sambarza in https://github.com/cheshire-cat-ai/core/pull/1106
- [V2] Class based agent tools by @lucagobbi in https://github.com/cheshire-cat-ai/core/pull/1111
- remove orphaned mcp registry route by @zarch in https://github.com/cheshire-cat-ai/core/pull/1127
New Contributors
- @BDadmehr0 made their first contribution in https://github.com/cheshire-cat-ai/core/pull/1051
- @primax79 made their first contribution in https://github.com/cheshire-cat-ai/core/pull/1057
- @davidebizzocchi made their first contribution in https://github.com/cheshire-cat-ai/core/pull/1070
- @zarch made their first contribution in https://github.com/cheshire-cat-ai/core/pull/1127
Full Changelog: https://github.com/cheshire-cat-ai/core/compare/1.9.0...2.0.19
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
[!WARNING] Version 2 is unstable alpha! This new version is still under heavy development and needs work before it becomes stable. Expect breaking changes, rough edges, and incomplete features. Not recommended for production use yet.
Cheshire Cat AI (Stregatto)
Best framework to learn how AI agents work.
It is designed bottom up to be easy to understand and easy to extend via vibe coding / agentic engineering.
Main use case of the Cat is education & research. Many companies and institutions use it to publish agents on the web.
Give the project a star ⭐ if you like creative cats!
Quickstart
In an empty folder:
uv init --bare
uv add cheshire-cat-ai
uv run ccat
- UI on localhost:1865
- REST API playground on localhost:1865/docs
Docs and Resources
Roadmap & Contributing
Roadmaps are for amateurs.
If you have a proposal, open an issue and only do a PR if the issue is assigned to you. Read the contributor guide.
License and trademark
Code is licensed under GPL3.
The Cheshire Cat AI logo and name are property of Piero Savastano (founder and maintainer).
Which way to go?
"Would you tell me, please, which way I ought to go from here?"
"That depends a good deal on where you want to get to," said the Cat.
"I don't much care where--" said Alice.
"Then it doesn't matter which way you go," said the Cat.
(Alice's Adventures in Wonderland - Lewis Carroll)