Practical overview
When it fits
Use Cheshire Cat AI when you want a self-hosted starting point for learning about agents or developing an educational or research prototype, and can work with a project whose Version 2 is marked unstable alpha.
Who it is for
- Learners exploring how AI agents work
- Researchers and developers building agent prototypes
- Developers exploring conversational agents, function calling, or MCP client integration
Documented uses
- Launch a local agent service for hands-on learning.
- Explore agent interaction through a REST API playground.
- Extend an agent framework for educational or research projects.
Requirements & limits
The documented quickstart runs the service locally. The repository lists the code under the GPL-3.0 license.
- The documented setup uses
uvand launches a local service. - The REST API playground is documented, but specific endpoints and authentication details are not described.
- Repository metadata identifies an MCP client; detailed supported-server compatibility is not specified.
- Version 2 is unstable alpha and the README advises against production use of that version.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the local Cheshire Cat AI service
Install and launch the package, then locate its local interface and REST API playground.
Before you start
- An empty project folder
- The
uvcommand-line tool
Steps
Initialize a bare project with the command below.
uv init --bareAdd the package with the command below.
uv add cheshire-cat-aiLaunch it with the command below.
uv run ccatOpen
localhost:1865for the UI orlocalhost:1865/docsfor the REST API playground.
Expected outcome
A locally running Cheshire Cat AI service with a UI and REST API playground.
Guide limitations
- The README labels Version 2 unstable alpha and says it is not recommended for production use yet.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- cheshire-cat-ai/core · Official homepage title · retained in its source language

