{"id":26172843,"url":"https://github.com/lss233/kirara-ai","last_synced_at":"2025-05-14T08:05:18.498Z","repository":{"id":64385801,"uuid":"574506496","full_name":"lss233/kirara-ai","owner":"lss233","description":"🤖 可 DIY 的 多模态 AI 聊天机器人 | 🚀 快速接入 微信、 QQ、Telegram、等聊天平台 | 🦈支持DeepSeek、Grok、Claude、Ollama、Gemini、OpenAI | 工作流系统、网页搜索、AI画图、人设调教、虚拟女仆、语音对话 | ","archived":false,"fork":false,"pushed_at":"2025-05-05T19:42:48.000Z","size":38752,"stargazers_count":15235,"open_issues_count":155,"forks_count":1673,"subscribers_count":80,"default_branch":"master","last_synced_at":"2025-05-13T14:23:35.309Z","etag":null,"topics":["bard","bot","chatglm-6b","chatgpt","deepseek","discord","ernie","go-cqhttp","grok","mirai","new-bing","ollama","openai","poe","qq","qqbot","sydney","telegram","wechat","xinghuo"],"latest_commit_sha":null,"homepage":"https://kirara-docs.app.lss233.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lss233.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-05T13:14:58.000Z","updated_at":"2025-05-13T11:47:15.000Z","dependencies_parsed_at":"2022-12-23T00:39:21.043Z","dependency_job_id":"81b8ce33-6c8c-45b6-9237-e8e7eb2d5e82","html_url":"https://github.com/lss233/kirara-ai","commit_stats":{"total_commits":1091,"total_committers":50,"mean_commits":21.82,"dds":0.5059578368469294,"last_synced_commit":"0aa5b690234e6018aebdbd2af162c73a3b049cc3"},"previous_names":["lss233/kirara-ai","lss233/chatgpt-mirai-qq-bot"],"tags_count":89,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lss233%2Fkirara-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lss233%2Fkirara-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lss233%2Fkirara-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lss233%2Fkirara-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lss233","download_url":"https://codeload.github.com/lss233/kirara-ai/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101588,"owners_count":22014907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bard","bot","chatglm-6b","chatgpt","deepseek","discord","ernie","go-cqhttp","grok","mirai","new-bing","ollama","openai","poe","qq","qqbot","sydney","telegram","wechat","xinghuo"],"created_at":"2025-03-11T20:00:31.467Z","updated_at":"2025-05-14T08:05:18.479Z","avatar_url":"https://github.com/lss233.png","language":"Python","funding_links":[],"categories":["Python","Chatbots"],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n  \u003ch2 align=\"center\"\u003eKirara AI\u003c/h2\u003e\n  \u003cp align=\"center\"\u003e\n    一款支持主流大语言模型、主流聊天平台的聊天的机器人！\n    \u003cbr/\u003e\n    \u003cbr/\u003e\n    \u003ca href=\"https://kirara-docs.app.lss233.com/\"\u003e\u003cstrong\u003e» 查看项目手册 »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr/\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lss233/kirara-ai/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/lss233/kirara-ai?color=F8B195\u0026amp;logo=github\u0026amp;style=for-the-badge\" alt=\"Github stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/kirara-ai/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/kirara-ai?color=F67280\u0026amp;logo=pypi\u0026amp;logoColor=white\u0026amp;style=for-the-badge\" alt=\"PyPI\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/lss233/kirara-ai?\u0026amp;color=C06C84\u0026amp;style=for-the-badge\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lss233/kirara-ai/actions/workflows/docker-latest.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/lss233/kirara-ai/docker-latest.yml?color=6C5B7B\u0026amp;logo=docker\u0026amp;logoColor=white\u0026amp;style=for-the-badge\" alt=\"Docker build latest\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/lss233/kirara-ai/\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/lss233/kirara-agent-framework?color=355C7D\u0026amp;logo=docker\u0026amp;logoColor=white\u0026amp;style=for-the-badge\" alt=\"Docker Pulls\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/lss233/kirara-ai\"\u003e\u003cimg alt=\"Codecov\" src=\"https://img.shields.io/codecov/c/gh/lss233/kirara-ai?color=A8E6CE\u0026amp;logo=codecov\u0026amp;logoColor=white\u0026amp;style=for-the-badge\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"Mypy checked\" src=\"https://img.shields.io/badge/Mypy-checked-DCEDC2?style=for-the-badge\u0026amp;logo=python\u0026amp;logoColor=white\"\u003e\n\u003c/p\u003e\n\n*** \n\n![cover](https://raw.githubusercontent.com/Haibersut/cnblog/refs/heads/main/230783378-34ddb86a-c8d3-47a6-baa5-86e39200b258.jpg)\n\n*** \n\n## 🌟 社区交流\n\n加入我们的社区，获取最新项目动态、视频教程、问题答疑和技术交流！\n\n* QQ 交流群:\n  * [二群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027\u0026k=S1R4eIlODtyKZsEKfWxb2-nOIHELbeJY\u0026authKey=kAftCAALE8OJgwQnArrD6zPtncCAaY456QgUXT3l2OMJ57NwRXRkhv4KL7DzOLzs\u0026noverify=0\u0026group_code=373254418)（已满）\n  * [三群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027\u0026k=urlhCH8y7Ro2S-iXt63X4s5eILUny4Iw\u0026authKey=ejiwoNa4Yez6IMLyf2vj%2FeRiC1frdFrNNekbRfaPnSQbcD7bgebo5y5A7rPaRKBq\u0026noverify=0\u0026group_code=533109074)（已满）\n  * [四群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027\u0026k=Ibiu6EmXof30Fa7MJ5j8nJFwaUGTf5bM\u0026authKey=YKx5a%2BK5qnWkk5VlsxxDfYl0nCrKSekQm%2FoLQVqr%2FcO%2FQY2S6N24XdI23XugBrF0\u0026noverify=0\u0026group_code=799737883)（已满）\n  * [五群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027\u0026k=lDkVPDAeiz6M-ig9cdS9tqhSH6_topox\u0026authKey=B%2FRPYVUjk3dYPw5D4o6C2TpqeoKTG0nXEiKDCG%2Bh4JYY2RPqDQGt37SGl32j0hHw\u0026noverify=0\u0026group_code=805081636)\n  * [六群](https://qm.qq.com/q/UpvYm3jccg)\n\n\n\u003e **提问前请先查看**: 加入群组前，请先查看[项目问题列表](https://github.com/lss233/kirara-ai/issues)，看是否能解决你的问题。\n\u003e \n\u003e 如需提问，请准备好问题描述、**完整日志**和相关配置文件，以便我们更好地帮助你。  \n\u003e 进群请备注：GitHub\n\n* [机器人调试群](https://jq.qq.com/?_wv=1027\u0026k=TBX8Saq7) - 这里有多个 QQ 机器人供体验，不解答技术问题。\n* [开发者交流群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027\u0026k=lisyXibhUj93DgIZptQu3VZ4ka3F5-rW\u0026authKey=PBCzRQX4Zei%2BB6n5Tdyp9p5bqcF0tLBlfGANT4dSSKQIFYR66WwaZSMEDahWo%2FzZ\u0026noverify=0\u0026group_code=701933732) - 欢迎参与 Kirara AI 及生态开发 / 对大模型应用有兴趣的开发者加入，一起交流学习。\n\n## 📷 功能展示\n\n| ![猫娘问答](https://img.shields.io/badge/-%E7%8C%AB%E5%A8%98%E9%97%AE%E7%AD%94-FF6B6B?style=for-the-badge\u0026logo=github\u0026logoColor=white) | ![智能助手](https://img.shields.io/badge/-智能助手-4ECDC4?style=for-the-badge\u0026logo=wechat\u0026logoColor=white) | ![沉浸式RPG](https://img.shields.io/badge/-沉浸式RPG-FFA07A?style=for-the-badge\u0026logo=discord\u0026logoColor=white) |\n|:-------------------------------:|:-------------------------------:|:-------------------------------:|\n| ![猫娘模式](https://user-images.githubusercontent.com/8984680/230702158-73967aa9-01be-44d6-bbd9-24437e333140.png) | ![日常助手](https://user-images.githubusercontent.com/8984680/230702177-de96f89b-053e-4313-a131-715af969db04.png) | ![文字冒险](https://user-images.githubusercontent.com/8984680/230702635-fb1de3bf-acbd-46ca-8d6f-caa47368b4d4.png) |\n\n## 🧭 WebUI  \n\n\u003cdiv align=\"center\"\u003e  \n\n\u003ch3 align=\"center\"\u003e模型管理\u003c/h3\u003e  \n\n![image](https://github.com/user-attachments/assets/0839bff6-47d4-4fe2-a326-056185ef1ad4)\n\n\n\u003ch3 align=\"center\"\u003e工作流\u003c/h3\u003e  \n\n![image](https://github.com/user-attachments/assets/c8ded878-3cf9-4c70-925d-ee29027674ff)\n\n\u003ch3 align=\"center\"\u003e插件市场\u003c/h3\u003e  \n\n![image](https://github.com/user-attachments/assets/d734be88-e8f6-4b95-aba8-02a544ab7a9f)\n\n\u003c/div\u003e\n\n## ⚡ 核心特性\n* [x] 图片发送\n* [x] 关键词触发回复\n* [x] 多账号支持\n* [x] 人格设定\n* [x] 支持 QQ、Telegram、Discord、微信  \n* [x] 可作为 HTTP 服务端提供 Web API\n* [x] 支持 OpenAI、DeepSeek、Claude、Gemini、Qwen、Mistral、豆包、Minimax、Kimi、Mistral 等主流大模型\n* [x] 支持插件机制\n* [x] 支持条件触发\n* [x] 支持管理员指令\n* [x] 支持 Stable Diffusion、Flux、Midjourney 等绘图模型\n* [x] 支持语音回复\n* [x] 支持多轮对话\n* [x] 支持跨平台消息发送\n* [x] 支持自定义工作流\n* [x] 支持 Web 管理后台\n* [x] 内置 Frpc 内网穿透\n\n# **🤖 聊天平台**  \n\n我们支持多种聊天平台。  \n\n| 平台       | 群聊回复 | 私聊回复 | 条件触发 | 管理员指令 | 绘图  | 语音回复 |\n|----------|------|------|------|-------|-----|------|\n| Telegram | 支持   | 支持   | 支持 | 支持  | 支持  | 支持   |\n| QQ 机器人 | 支持   | 支持   | 支持 | 支持  | 支持  | 平台不支持   |\n| Discord  | 重构中   | 重构中   | 重构中 | 重构中  | 重构中  | 重构中   |\n| 飞书机器人  | 重构中   | 重构中   | 重构中 | 重构中  | 重构中  | 重构中   |\n| 企业微信应用 | 支持   | 支持   | 支持 | 不支持  | 支持  | 支持   |\n| 微信公众号 | 支持   | 支持   | 支持 | 不支持  | 支持  | 支持   |\n| OneBot   | 插件支持   | 插件支持   | 插件支持   | 插件支持    | 插件支持  | 插件支持   |\n\n## 🐎 命令\n\n**你可以在 WebUI 的调度规则中自定义所有命令。**  \n\n\n## 🔧 搭建\n\n请移步至 [快速开始](https://kirara-docs.app.lss233.com/guide/getting-started.html)\n\n## 🕸 HTTP API\n\n\u003cdetails\u003e\n    \u003csummary\u003eHTTP API 可用于接入其他平台。\u003c/summary\u003e\n在聊天平台管理中启动 http-legacy 适配器后，将提供以下接口：  \n\n**POST**    `/v1/chat`  \n\n**请求参数**  \n\n|参数名|必选|类型|说明|\n|:---|:---|:---|:---|\n|session_id| 是 | String |会话ID，默认：`friend-default_session`|\n|username| 是 | String |用户名，默认：`某人`|\n|message| 是 | String |消息，不能为空|  \n\n**请求示例**\n```json\n{\n    \"session_id\": \"friend-123456\",\n    \"username\": \"testuser\",\n    \"message\": \"ping\"\n}\n```\n**响应格式**\n|参数名|类型|说明|\n|:---|:---|:---|\n|result| String |SUCESS,DONE,FAILED|\n|message| String[] |文本返回，支持多段返回|\n|voice| String[] |音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...|\n|image| String[] |图片返回，支持多个图片的base64编码；参考：data:image/png;base64,...|\n\n**响应示例**  \n```json\n{\n    \"result\": \"DONE\",\n    \"message\": [\"pong!\"],\n    \"voice\": [],\n    \"image\": []\n}\n```\n\n**POST**    `/v2/chat`  \n\n**请求参数**  \n\n|参数名|必选|类型|说明|\n|:---|:---|:---|:---|\n|session_id| 是 | String |会话ID，默认：`friend-default_session`|\n|username| 是 | String |用户名，默认：`某人`|\n|message| 是 | String |消息，不能为空|  \n\n**请求示例**\n```json\n{\n    \"session_id\": \"friend-123456\",\n    \"username\": \"testuser\",\n    \"message\": \"ping\"\n}\n```\n**响应格式**\n字符串：request_id\n\n**响应示例**  \n```\n1681525479905\n```\n\n**GET**    `/v2/chat/response`  \n\n**请求参数**  \n\n|参数名|必选|类型|说明|\n|:---|:---|:---|:---|\n|request_id| 是 | String |请求id，/v2/chat返回的值|\n\n**请求示例**\n```\n/v2/chat/response?request_id=1681525479905\n```\n**响应格式**\n|参数名|类型|说明|\n|:---|:---|:---|\n|result| String |SUCESS,DONE,FAILED|\n|message| String[] |文本返回，支持多段返回|\n|voice| String[] |音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...|\n|image| String[] |图片返回，支持多个图片的base64编码；参考：data:image/png;base64,...|\n\n* 每次请求返回增量并清空。DONE、FAILED之后没有更多返回。\n\n**响应示例**  \n```json\n{\n    \"result\": \"DONE\",\n    \"message\": [\"pong!\"],\n    \"voice\": [\"data:audio/mpeg;base64,...\"],\n    \"image\": [\"data:image/png;base64,...\", \"data:image/png;base64,...\"]\n}\n```\n\u003c/details\u003e\n\n## 🦊 加载预设\n\n如果你想让机器人自动带上某种聊天风格，可以使用预设功能。  \n\n我们自带了 `猫娘` 和 `正常` 两种预设，你可以在 `presets` 文件夹下了解预设的写法。  \n\n使用 `加载预设 猫娘` 来加载猫娘预设。\n\n下面是一些预设的小视频，你可以看看效果：\n* MOSS： https://www.bilibili.com/video/av352047018\n* 丁真：https://www.bilibili.com/video/av267013053\n* 小黑子：https://www.bilibili.com/video/av309604568\n* 高启强：https://www.bilibili.com/video/av779555493\n\n关于预设系统的详细教程：[Wiki](https://github.com/lss233/kirara-ai/wiki/%F0%9F%90%B1-%E9%A2%84%E8%AE%BE%E7%B3%BB%E7%BB%9F)\n\n你可以在 [Awesome ChatGPT QQ Presets](https://github.com/lss233/awesome-chatgpt-qq-presets/tree/master) 获取由大家分享的预设。\n\n你也可以参考 [Awesome-ChatGPT-prompts-ZH_CN](https://github.com/L1Xu4n/Awesome-ChatGPT-prompts-ZH_CN) 来调教你的 ChatGPT，还可以参考 [Awesome ChatGPT Prompts](https://github.com/f/awesome-chatgpt-prompts) 来解锁更多技能。 \n\n## 🎙 文字转语音\n\n自 v2.2.5 开始，我们支持接入微软的 Azure 引擎 和 VITS 引擎，让你的机器人发送语音。\n\n**提示**：在 Windows 平台上使用语音功能需要安装最新的 VC 运行库，你可以在[这里](https://learn.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist?view=msvc-170)下载。`\n\n## 🛠 贡献者名单   \n\n欢迎提出新的点子、 Pull Request。  \n\n\u003ca href=\"https://github.com/lss233/kirara-ai/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=lss233/kirara-ai\" /\u003e\n\u003c/a\u003e\n\nMade with [contrib.rocks](https://contrib.rocks).\n\n## 📕 相关项目\n\n- [Kirara Registry](https://github.com/DarkSkyTeam/kirara-registry) - Kirara AI 插件市场\n- [Kirara WebUI](https://github.com/DarkSkyTeam/kirara-webui) - Kirara AI 的 WebUI 前端项目\n- [Kirara Docs](https://github.com/DarkSkyTeam/kirara-docs) - Kirara AI 的使用手册原始文档\n\n## 💪 支持我们\n\n如果我们这个项目对你有所帮助，请给我们一颗 ⭐️  \n\n[![Star History Chart](https://api.star-history.com/svg?repos=lss233/kirara-ai\u0026type=Date)](https://www.star-history.com/#lss233/kirara-ai\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flss233%2Fkirara-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flss233%2Fkirara-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flss233%2Fkirara-ai/lists"}