项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3099
使用教程
环境要求
- 已安装 uv(Python 包管理工具)
- 准备一个空文件夹作为项目目录
- 浏览器(用于访问 Web UI 和 API 文档)
安装与启动步骤
-
1新建空目录
在任意位置创建一个空文件夹并进入,后续所有命令都在该目录内执行,README 要求从空文件夹开始。
mkdir cheshire-cat cd cheshire-cat -
2初始化 uv 项目
使用 uv init --bare 在当前目录生成最小化的 Python 项目结构,不创建示例代码。
uv init --bare -
3安装核心包
通过 uv add 安装 cheshire-cat-ai 包及其依赖,由 uv 自动管理虚拟环境。
uv add cheshire-cat-ai -
4启动服务
执行 ccat 命令启动 Cheshire Cat 服务,启动后保持终端不关闭。
uv run ccat -
5访问界面
在浏览器打开 Web UI 地址;如需调试接口,可打开 REST API 调试页查看和调用接口。
如何确认成功
终端无报错后,浏览器打开 http://localhost:1865 能看到 Web UI;打开 http://localhost:1865/docs 能看到 REST API playground,即启动成功。
常见问题
Q:可以直接用于生产环境吗?
A:README 明确提示 Version 2 仍是不稳定 alpha,会有破坏性变更和未完成功能,不推荐用于生产环境,主要用于教育与研究。
Q:Web UI 和 API 地址是什么?
A:UI 位于 http://localhost:1865,REST API playground 位于 http://localhost:1865/docs。
Q:没有安装 uv 怎么办?
A:README 的 Quickstart 只给出 uv 方式的安装命令,请先按 uv 官方说明安装 uv 后再执行上述步骤。
Q:遇到问题或想贡献代码?
A:按 README 建议先提 issue 说明你的想法;只有在 issue 被分配给你之后再提交 PR,并先阅读贡献者指南。
注意事项
- 当前 Version 2 为不稳定 alpha,可能出现破坏性变更与不完整功能,请勿用于生产。
- Quickstart 要求在空文件夹中执行,避免与已有项目结构冲突。
- 代码采用 GPL3 许可;Cheshire Cat AI 的 logo 与名称归创始人 Piero Savastano 所有。
- 更多资料见官方文档站点与项目官网 cheshirecat.ai。
核心亮点
- 内置 MCP 客户端,轻松接入外部工具和数据源
- 支持函数调用,智能体可执行复杂任务
- Docker 化部署,环境一致且启动迅速
不足之处
- 文档/社区待观察
- 项目较新,生态和示例相对有限
适用场景
- 企业内部知识库问答机器人
- 跨平台客服助手(网页/移动端)
- 自动化工作流中的智能决策节点
替代项目
Rasa、Botpress、Dify
同类项目推荐
openmcp-client
开源
在 VS Code 里一站式开发、调试和测试 MCP 服务器,省去切换工具的麻烦。
All in one vscode plugin for mcp developer
stashbase
开源
把本地文件变成 AI 的搜索库,让智能体秒懂你的资料。
An open-source, local-first writing workspace where you can write with Claude Code a···
generative-agents
开源
本地跑起斯坦福AI小镇,低成本模拟人类行为
Working, locally-running, low-cost implementation of Generative Agents: Interactive ···
designpowers
开源
指挥10个AI智能体,自动跑完设计全流程
An agent design team you control: 10 agents that run an inclusive design process whi···
memorix
开源
让所有 AI 编程助手共享记忆,告别重复上下文。
Open-source cross-agent memory layer for coding agents via MCP. Compatible with Clau···
Memslides
开源
让 AI 记住你的演示偏好,越用越懂你
A hierarchical memory framework for personalized presentation agents. Try it at mems···
papa-ts
开源
浏览器里跑私有 AI,离线也能聊
This library exposes PAPA, your Personal Assistant powered by Private AI, which can ···
garcon
开源
在浏览器里并行指挥多个 AI 编码代理,边看边改边发布
Self-hosted browser workspace to run coding agents in parallel, steer work as it run···
specops
开源
让 AI 先想清楚再写码,减少返工
Make your AI agent think before it codes.
