README

Kirara AI
  
    一款支持主流大语言模型、主流聊天平台的聊天的机器人！
    
    
    » 查看项目手册 »
    
  



  
  
  



  
  
  
  


 

!cover

 

 🌟 社区交流

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

 QQ 交流群:
   二群（已满）
   三群（已满）
   四群（已满）
   五群
   六群


 提问前请先查看: 加入群组前，请先查看项目问题列表，看是否能解决你的问题。
 
 如需提问，请准备好问题描述、完整日志和相关配置文件，以便我们更好地帮助你。  
 进群请备注：GitHub

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

 📷 功能展示

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

 🧭 WebUI  

  

模型管理  

!image


工作流  

!image

插件市场  

!image



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

 🤖 聊天平台  

我们支持多种聊天平台。  

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

 🐎 命令

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


 🔧 搭建

请移步至 快速开始

 🕸 HTTP API


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

POST    /v1/chat  

请求参数  

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

请求示例
json
{
    "session_id": "friend-123456",
    "username": "testuser",
    "message": "ping"
}

响应格式
|参数名|类型|说明|
|:---|:---|:---|
|result| String |SUCESS,DONE,FAILED|
|message| String[] |文本返回，支持多段返回|
|voice| String[] |音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...|
|image| String[] |图片返回，支持多个图片的base64编码；参考：data:image/png;base64,...|

响应示例  
json
{
    "result": "DONE",
    "message": ["pong!"],
    "voice": [],
    "image": []
}


POST    /v2/chat  

请求参数  

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

请求示例
json
{
    "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

响应格式
|参数名|类型|说明|
|:---|:---|:---|
|result| String |SUCESS,DONE,FAILED|
|message| String[] |文本返回，支持多段返回|
|voice| String[] |音频返回，支持多个音频的base64编码；参考：data:audio/mpeg;base64,...|
|image| String[] |图片返回，支持多个图片的b