Metadata-Version: 2.4
Name: cheshire-cat-ai
Version: 2.0.22
Summary: Production ready AI agent framework
Project-URL: Homepage, https://github.com/cheshire-cat-ai/core
Project-URL: Issues, https://github.com/cheshire-cat-ai/core/issues
Author: Piero Savastano, Cheshire Cat AI Contributors
License-Expression: GPL-3.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: ag-ui-protocol>=0.1.13
Requires-Dist: aiofiles>=24.1.0
Requires-Dist: asgi-lifespan>=2.1.0
Requires-Dist: bcrypt>=4.1.3
Requires-Dist: cachetools>=6.2.0
Requires-Dist: fastapi[standard]>=0.121.0
Requires-Dist: fastmcp>=2.12.4
Requires-Dist: httpx>=0.28.1
Requires-Dist: loguru>=0.7.2
Requires-Dist: openai>=2.42.0
Requires-Dist: piccolo[orjson,postgres,sqlite]>=1.30.0
Requires-Dist: pydantic>=2.12.4
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: pytest
Requires-Dist: pytest-asyncio
Requires-Dist: python-slugify>=8.0.1
Requires-Dist: ruff>=0.4.7
Requires-Dist: uvicorn[standard]>=0.38.0
Description-Content-Type: text/markdown

<a name="readme-top"></a>

<p align="center">
    <img align="center" src=./readme/logo.svg width=200px alt="Cheshire Cat AI logo">
</p>

> [!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:

```bash
uv init --bare
uv add cheshire-cat-ai
uv run ccat
```
- UI on [localhost:1865](http://localhost:1865)
- REST API playground on [localhost:1865/docs](http://localhost:1865/docs)


## Docs and Resources

- [Official Documentation](https://cheshire-cat-ai.github.io/docs/)
- [Discord Server](https://discord.gg/bHX5sNFCYU)
- [Website](https://cheshirecat.ai/)


## 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](./readme/CONTRIBUTING.md).

## License and trademark

Code is licensed under [GPL3](./LICENSE).  
The Cheshire Cat AI logo and name are property of Piero Savastano (founder and maintainer).

## Which way to go?

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<p align="center">
    <img align="center" src=./readme/cheshire-cat.jpeg width=400px alt="Wikipedia picture of the Cheshire Cat">
</p>

```
"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)

```
