[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10703":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":39,"readmeContent":40,"aiSummary":41,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":42,"discoverSource":43},10703,"core","cheshire-cat-ai\u002Fcore","cheshire-cat-ai","AI agent microservice","https:\u002F\u002Fcheshirecat.ai",null,"Python",3040,400,37,6,0,2,7,61.51,"GNU General Public License v3.0",false,"main",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"ag-ui-protocol","agent","ai","assistant","chatbot","conversational","docker","framework","function-calling","llm","mcp","mcp-client","plugin","python","vector-search","2026-06-12 04:00:51","\u003Ca name=\"readme-top\">\u003C\u002Fa>\n\n\u003C!-- PROJECT LOGO -->\n\u003Cbr \u002F>\n\u003Cdiv align=\"center\">\n  \u003Ch2>Cheshire Cat AI\u003C\u002Fh2>\n  \u003Ch3>🇮🇹 Stregatto - 🇨🇳 柴郡貓 - 🇮🇳 चेशायर बिल्ली - 🇷🇺 Чеширский кот\u003C\u002Fh3>\n\u003Cbr\u002F>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcheshire-cat-ai\u002Fcore\">\n  \u003Cimg alt=\"GitHub Repo stars\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fcheshire-cat-ai\u002Fcore?style=social\">\n\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FbHX5sNFCYU\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1092359754917089350?logo=discord\"\n            alt=\"chat on Discord\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcheshire-cat-ai\u002Fcore\u002Fissues\">\n  \u003Cimg alt=\"GitHub issues\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fcheshire-cat-ai\u002Fcore\">\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcheshire-cat-ai\u002Fcore\u002Ftags\">\n  \u003Cimg alt=\"GitHub tag (with filter)\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Ftag\u002Fcheshire-cat-ai\u002Fcore\">\n  \u003C\u002Fa>\n  \u003Cimg alt=\"GitHub top language\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Ftop\u002Fcheshire-cat-ai\u002Fcore\">\n\n  \u003Cbr\u002F>\n  \u003Cvideo src=\"https:\u002F\u002Fgithub.com\u002Fcheshire-cat-ai\u002Fcore\u002Fassets\u002F6328377\u002F7bc4acff-34bf-4b8a-be61-4d8967fbd60f\">\u003C\u002Fvideo>\n\u003C\u002Fdiv>\n\n## AI agent as a microservice\n\nThe Cheshire Cat is a framework to build custom AI agents:\n\n- ⚡️ API first, to easily add a conversational layer to your app\n- 💬 Chat via WebSocket and manage your agent with an customizable REST API\n- 🐘 Built-in RAG with Qdrant\n- 🚀 Extensible via plugins\n- 🪛 Event callbacks, function calling (tools), conversational forms\n- 🏛 Easy to use admin panel\n- 🌍 Supports any language model via langchain\n- 👥 Multiuser with granular permissions, compatible with any identity provider\n- 🐋 100% dockerized\n- 🦄 Active [Discord community](https:\u002F\u002Fdiscord.gg\u002FbHX5sNFCYU) and easy to understand [docs](https:\u002F\u002Fcheshire-cat-ai.github.io\u002Fdocs\u002F)\n \n\n\n## Quickstart\n\nTo make Cheshire Cat run on your machine, you just need [`docker`](https:\u002F\u002Fdocs.docker.com\u002Fget-docker\u002F) installed:\n\n```bash\ndocker run --rm -it -p 1865:80 ghcr.io\u002Fcheshire-cat-ai\u002Fcore:latest\n```\n- Chat with the Cheshire Cat on [localhost:1865\u002Fadmin](http:\u002F\u002Flocalhost:1865\u002Fadmin)\n- Try out the REST API on [localhost:1865\u002Fdocs](http:\u002F\u002Flocalhost:1865\u002Fdocs)\n\nEnjoy the Cat!  \nFollow instructions on how to run it properly with [docker compose and volumes](https:\u002F\u002Fcheshire-cat-ai.github.io\u002Fdocs\u002Fquickstart\u002Finstallation-configuration\u002F).\n\n## Minimal plugin example\n\n\u003Cdetails>\n    \u003Csummary>\n        Hooks (events)\n    \u003C\u002Fsummary>\n\n```python\nfrom cat.mad_hatter.decorators import hook\n\n# hooks are an event system to get finegraned control over your assistant\n@hook\ndef agent_prompt_prefix(prefix, cat):\n    prefix = \"\"\"You are Marvin the socks seller, a poetic vendor of socks.\nYou are an expert in socks, and you reply with exactly one rhyme.\n\"\"\"\n    return prefix\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n    \u003Csummary>\n        Tools\n    \u003C\u002Fsummary>\n\n```python\nfrom cat.mad_hatter.decorators import tool\n\n# langchain inspired tools (function calling)\n@tool(return_direct=True)\ndef socks_prices(color, cat):\n    \"\"\"How much do socks cost? Input is the sock color.\"\"\"\n    prices = {\n        \"black\": 5,\n        \"white\": 10,\n        \"pink\": 50,\n    }\n\n    price = prices.get(color, 0)\n    return f\"{price} bucks, meeeow!\" \n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n    \u003Csummary>\n        Conversational Forms\n    \u003C\u002Fsummary>\n\n## Conversational form example\n\n```python\nfrom pydantic import BaseModel\nfrom cat.experimental.form import form, CatForm\n\n# data structure to fill up\nclass PizzaOrder(BaseModel):\n    pizza_type: str\n    phone: int\n\n# forms let you control goal oriented conversations\n@form\nclass PizzaForm(CatForm):\n    description = \"Pizza Order\"\n    model_class = PizzaOrder\n    start_examples = [\n        \"order a pizza!\",\n        \"I want pizza\"\n    ]\n    stop_examples = [\n        \"stop pizza order\",\n        \"not hungry anymore\",\n    ]\n    ask_confirm = True\n\n    def submit(self, form_data):\n        \n        # do the actual order here!\n\n        # return to convo\n        return {\n            \"output\": f\"Pizza order on its way: {form_data}\"\n        }\n```\n\u003C\u002Fdetails>\n\n## Docs and Resources\n\n- [Official Documentation](https:\u002F\u002Fcheshire-cat-ai.github.io\u002Fdocs\u002F)\n- [Discord Server](https:\u002F\u002Fdiscord.gg\u002FbHX5sNFCYU)\n- [Website](https:\u002F\u002Fcheshirecat.ai\u002F)\n- [Tutorial - Write your first plugin](https:\u002F\u002Fcheshirecat.ai\u002Fwrite-your-first-plugin\u002F)\n\n\n## Roadmap & Contributing\n\n*Attention*: while version 2 is being worked out, we'll only accept bug fixes for v1. Send your PR for v1 on branch `develop`.\nDo not expect to see merged PRs not previously discussed and agreed upon in an issue.\n\nDetailed roadmap is [here](.\u002FROADMAP.md).  \nSend your pull request to the `develop` branch. Here is a [full guide to contributing](.\u002FCONTRIBUTING.md).\n\nWe are committed to openness, privacy and creativity, we want to bring AI to the long tail. If you want to know more about our vision and values, read the [Code of Ethics](.\u002FCODE-OF-ETHICS.md). \n\nJoin our [community on Discord](https:\u002F\u002Fdiscord.gg\u002FbHX5sNFCYU) and give the project a star ⭐!\nThanks again!🙏\n\n## License and trademark\n\nCode is licensed under [GPL3](.\u002FLICENSE).  \nThe Cheshire Cat AI logo and name are property of Piero Savastano (founder and maintainer).\n\n## Which way to go?\n\n\u003Cp align=\"right\">(\u003Ca href=\"#readme-top\">back to top\u003C\u002Fa>)\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n    \u003Cimg align=\"center\" src=.\u002Freadme\u002Fcheshire-cat.jpeg width=400px alt=\"Wikipedia picture of the Cheshire Cat\">\n\u003C\u002Fp>\n\n```\n\"Would you tell me, please, which way I ought to go from here?\"\n\"That depends a good deal on where you want to get to,\" said the Cat.\n\"I don't much care where--\" said Alice.\n\"Then it doesn't matter which way you go,\" said the Cat.\n\n(Alice's Adventures in Wonderland - Lewis Carroll)\n\n```\n","Cheshire Cat AI 是一个用于构建自定义AI代理的微服务框架。它提供了API优先的设计，支持通过WebSocket进行聊天，并通过可定制的REST API管理代理。项目内置了基于Qdrant的检索增强生成（RAG）功能，支持通过插件扩展，包括事件回调、函数调用和对话表单等高级特性。此外，它还具有易于使用的管理面板，能够与任何语言模型兼容，并且支持多用户访问控制。完全容器化的设计使得部署变得简单快捷。Cheshire Cat AI 适合需要快速集成智能对话层的应用场景，如客户服务自动化、虚拟助手等。","2026-06-11 03:29:47","top_topic"]