Metadata-Version: 2.4
Name: cheshire-cat-ai
Version: 2.0.17
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=400px 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 with coding agents.

Main use case of the Cat is to give [Pollo Watzlawick](https://www.youtube.com/@PieroSavastano) a real consciousness. But you can also use it to have fun, learn AI and bring your agents on the web.


## Quickstart

In an empty folder:

```bash
uv init --bare
uv add cheshire-cat-ai
uv run ccat
```
- Chat with the Cat on [localhost:1865](http://localhost:1865)
- Try out the REST API 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.

I will be accepting PRs directly on branch `main` and only for assigned issues.

Give the project a star ⭐!

## 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)

```
