back to home

lss233 / kirara-ai

🤖 可 DIY 的 多模态 AI 聊天机器人 | 🚀 快速接入 微信、 QQ、Telegram、等聊天平台 | 🦈支持DeepSeek、Grok、Claude、Ollama、Gemini、OpenAI | 工作流系统、网页搜索、AI画图、人设调教、虚拟女仆、语音对话 |

18,372 stars
1,830 forks
8 issues
PythonDockerfileShell
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing lss233/kirara-ai in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/lss233/kirara-ai)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview
<p align="center"> <h2 align="center">Kirara AI</h2> <p align="center"> 一款支持主流大语言模型、主流聊天平台的聊天的机器人！ <br/> <br/> <a href="https://kirara-docs.app.lss233.com/"><strong>» 查看项目手册 »</strong></a> <br/> </p> </p> <p align="center"> <a href="https://github.com/lss233/kirara-ai/stargazers"><img src="https://img.shields.io/github/stars/lss233/kirara-ai?color=F8B195&amp;logo=github&amp;style=for-the-badge" alt="Github stars"></a> <a href="https://pypi.org/project/kirara-ai/"><img src="https://img.shields.io/pypi/v/kirara-ai?color=F67280&amp;logo=pypi&amp;logoColor=white&amp;style=for-the-badge" alt="PyPI"></a> <a href="./LICENSE"><img src="https://img.shields.io/github/license/lss233/kirara-ai?&amp;color=C06C84&amp;style=for-the-badge" alt="License"></a> </p> <p align="center"> <a href="https://github.com/lss233/kirara-ai/actions/workflows/docker-latest.yml"><img src="https://img.shields.io/github/actions/workflow/status/lss233/kirara-ai/docker-latest.yml?color=6C5B7B&amp;logo=docker&amp;logoColor=white&amp;style=for-the-badge" alt="Docker build latest"></a> <a href="https://hub.docker.com/r/lss233/kirara-ai/"><img src="https://img.shields.io/docker/pulls/lss233/kirara-agent-framework?color=355C7D&amp;logo=docker&amp;logoColor=white&amp;style=for-the-badge" alt="Docker Pulls"></a> <a href="https://codecov.io/gh/lss233/kirara-ai"><img alt="Codecov" src="https://img.shields.io/codecov/c/gh/lss233/kirara-ai?color=A8E6CE&amp;logo=codecov&amp;logoColor=white&amp;style=for-the-badge"></a> <img alt="Mypy checked" src="https://img.shields.io/badge/Mypy-checked-DCEDC2?style=for-the-badge&amp;logo=python&amp;logoColor=white"> </p>

cover

🌟 社区交流

加入我们的社区，获取最新项目动态、视频教程、问题答疑和技术交流！

提问前请先查看: 加入群组前，请先查看项目问题列表，看是否能解决你的问题。

如需提问，请准备好问题描述、完整日志和相关配置文件，以便我们更好地帮助你。
进群请备注：GitHub

  • 机器人调试群 - 这里有多个 QQ 机器人供体验，不解答技术问题。
  • 开发者交流群 - 欢迎参与 Kirara AI 及生态开发 / 对大模型应用有兴趣的开发者加入，一起交流学习。

📷 功能展示

猫娘问答智能助手沉浸式RPG
猫娘模式日常助手文字冒险

🧭 WebUI

<div align="center"> <h3 align="center">模型管理</h3>

image

<h3 align="center">工作流</h3>

image

<h3 align="center">插件市场</h3>

image

</div>

⚡ 核心特性

  • 图片发送
  • 关键词触发回复
  • 多账号支持
  • 人格设定
  • 支持 QQ、Telegram、Discord、微信
  • 可作为 HTTP 服务端提供 Web API
  • 支持 OpenAI、DeepSeek、Claude、Gemini、Qwen、Mistral、豆包、Minimax、Kimi、Mistral 等主流大模型
  • 支持插件机制
  • 支持条件触发
  • 支持管理员指令
  • 支持 Stable Diffusion、Flux、Midjourney 等绘图模型
  • 支持语音回复
  • 支持多轮对话
  • 支持跨平台消息发送
  • 支持自定义工作流
  • 支持 Web 管理后台
  • 内置 Frpc 内网穿透

🤖 聊天平台

我们支持多种聊天平台。

平台群聊回复私聊回复条件触发管理员指令绘图语音回复
Telegram支持支持支持支持支持支持
QQ 机器人支持支持支持支持支持平台不支持
Discord重构中重构中重构中重构中重构中重构中
飞书机器人重构中重构中重构中重构中重构中重构中
企业微信应用支持支持支持不支持支持支持
微信公众号支持支持支持不支持支持支持
OneBot插件支持插件支持插件支持插件支持插件支持插件支持

🐎 命令

你可以在 WebUI 的调度规则中自定义所有命令。

🔧 搭建

请移步至 快速开始

🕸 HTTP API

<details> <summary>HTTP API 可用于接入其他平台。</summary> 在聊天平台管理中启动 http-legacy 适配器后，将提供以下接口：

POST /v1/chat

请求参数

参数名必选类型说明
session_id是String会话ID，默认：friend-default_session
username是String用户名，默认：某人
message是String消息，不能为空

请求示例

{
    "session_id": "friend-123456",
    "username": "testuser",
    "message": "ping"
}

响应格式

参数名类型说明
resultStringSUCESS,DONE,FAILED
messageString[]文本返回，支持多段返回
voiceString[]音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...
imageString[]图片返回，支持多个图片的base64编码；参考：data:image/png;base64,...

响应示例

{
    "result": "DONE",
    "message": ["pong!"],
    "voice": [],
    "image": []
}

POST /v2/chat

请求参数

参数名必选类型说明
session_id是String会话ID，默认：friend-default_session
username是String用户名，默认：某人
message是String消息，不能为空

请求示例

{
    "session_id": "friend-123456",
    "username": "testuser",
    "message": "ping"
}

响应格式 字符串：request_id

响应示例

1681525479905

GET /v2/chat/response

请求参数

参数名必选类型说明
request_id是String请求id，/v2/chat返回的值

请求示例

/v2/chat/response?request_id=1681525479905

响应格式

参数名类型说明
resultStringSUCESS,DONE,FAILED
messageString[]文本返回，支持多段返回
voiceString[]音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...
imageString[]图片返回，支持多个图片的base64编码；参考：data:image/png;base64,...
  • 每次请求返回增量并清空。DONE、FAILED之后没有更多返回。

响应示例

{
    "result": "DONE",
    "message": ["pong!"],
    "voice": ["data:audio/mpeg;base64,..."],
    "image": ["data:image/png;base64,...", "data:image/png;base64,..."]
}
</details>

🦊 加载预设

如果你想让机器人自动带上某种聊天风格，可以使用预设功能。

我们自带了 猫娘 和 正常 两种预设，你可以在 presets 文件夹下了解预设的写法。

使用 加载预设 猫娘 来加载猫娘预设。

下面是一些预设的小视频，你可以看看效果：

关于预设系统的详细教程：Wiki

你可以在 Awesome ChatGPT QQ Presets 获取由大家分享的预设。

你也可以参考 Awesome-ChatGPT-prompts-ZH_CN 来调教你的 ChatGPT，还可以参考 Awesome ChatGPT Prompts 来解锁更多技能。

🎙 文字转语音

自 v2.2.5 开始，我们支持接入微软的 Azure 引擎 和 VITS 引擎，让你的机器人发送语音。

提示：在 Windows 平台上使用语音功能需要安装最新的 VC 运行库，你可以在这里下载。`

🛠 贡献者名单

欢迎提出新的点子、 Pull Request。

<a href="https://github.com/lss233/kirara-ai/graphs/contributors"> <img src="https://contrib.rocks/image?repo=lss233/kirara-ai" /> </a>

Made with contrib.rocks.

📕 相关项目

💪 支持我们

如果我们这个项目对你有所帮助，请给我们一颗 ⭐️

Star History Chart