在桌面上运行有形象、有声音、有长期记忆的 AI 角色。
选择或导入角色，连接自己的模型服务，然后开始一段会延续下去的对话。
下载安装 · 10 分钟快速开始 · 故障排查 · 架构 · 贡献
- 让桌面角色根据当前屏幕内容作出反应。
- 导入 SillyTavern 角色卡，用不同人格延续各自的对话与记忆。
- 连接本地或云端 LLM，并按需开启语音、视觉、MCP、MOD 和 Bot 能力。
三个内置角色、主界面角色选择和首次回复引导正在按角色生态设计实施，当前发布版请先使用设置中的角色管理与导入功能。
Kokoro Engine 不是“聊天壳子 + 桌宠皮肤”。它是一个完整的桌面角色运行时：
- All-in-one：Live2D、LLM、TTS、STT等技术集成在一个运行时闭环。
- Built for extensibility：高自由度 MOD 系统 + MCP 协议，天然面向扩展。
- Local-first：本地存储记忆、离线优先、数据链路可控。
| 维度 | 内容 |
|---|---|
| 面向用户 | 虚拟角色创作者、开发者、普通用户 |
| 交互能力 | 文本、语音、图片、视觉输入、多模态对话 |
| 扩展方式 | MOD（HTML/CSS/JS + QuickJS）、MCP Servers |
| 技术栈 | React + TypeScript + Rust + Tauri v2 + SQLite |
| 语言支持 | 简体中文 / 繁體中文 / English / 日本語 / 한국어 / Русский |
主界面
设置界面
前往 Releases 页面 下载对应平台安装包后直接运行。
git clone https://github.com/chyinan/kokoro-engine.git
cd kokoro-engine
npm install
npm run tauri devnpm run tauri buildnix develop
npm install
npm run tauri dev更多 Nix 用法见 docs/nix.md。
- Live2D 渲染、视线追踪、动作触发、桌面浮窗
- 模型热切换、帧率自定义
- 支持 Ollama 、llama.cpp 与 OpenAI 、Anthropic 兼容协议API接口
Codex Runtime — Experimental：可选的本机运行时桥接，通过codex app-server --listen stdio://复用用户现有的 Codex 认证、模型与 provider 配置；Kokoro 不读取或存储 Codex 凭据，也不修改 Codex 配置。详见 Codex Runtime 文档。- 支持多模态输入、上下文回溯、长期记忆与情感状态
- TTS（文本转语音）：GPT-SoVITS、VITS、OmniVoice、OpenAI、Azure、ElevenLabs、Edge TTS、Browser TTS
- STT（语音转文本）：Whisper / faster-whisper / whisper.cpp / SenseVoice
- 支持 VAD 自动停录与唤醒词链路
- MOD 框架：HTML/CSS/JS 超高自由度 UI 主题替换 + QuickJS 脚本沙箱
- MCP 支持：连接 MCP Server 并调用外部工具
- 内置官方示范 MOD：
mods/genshin-theme - 支持 SillyTavern 角色卡导入功能（酒馆）
- 内置 QQ、Telegram、Discord、LINE、Webhook 五种 Bot 服务
- AstrBot 集成：通过带认证的通用 Webhook 将 AstrBot 消息接入 Kokoro，支持按角色与会话处理文本、图片和音频，并返回文本或媒体响应。详见 AstrBot 集成文档。
- 将各平台支持的消息类型桥接到 AI 管线
flowchart LR
subgraph FE["Frontend (React + TypeScript)"]
FE_UI["UI Layout Engine"]
FE_REG["Component Registry"]
FE_THEME["Theme & MOD UI"]
FE_BRIDGE["kokoro-bridge.ts"]
FE_UI --> FE_REG
FE_REG --> FE_THEME
FE_THEME --> FE_BRIDGE
end
subgraph IPC["Tauri Typed IPC"]
IPC_INVOKE["invoke / events"]
end
subgraph BE["Backend (Rust / Tauri v2)"]
BE_CMD["Commands Layer"]
BE_ORCH["AI Orchestrator"]
BE_MULTI["LLM / TTS / STT / Vision / ImageGen / MCP"]
BE_MOD["MOD Runtime (QuickJS)"]
BE_BOT["Bot Bridges (QQ / Telegram / Discord / LINE / Webhook)"]
BE_CMD --> BE_ORCH
BE_ORCH --> BE_MULTI
BE_MOD --> BE_CMD
BE_BOT --> BE_CMD
end
subgraph DATA["Data & Runtime Config"]
DB[("SQLite: memories / summaries / conversations / characters")]
CFG["Config Files: llm/tts/stt/vision/imagegen/mcp/bot"]
end
subgraph EXT["External Services"]
EXT_LLM["OpenAI-Compatible / Ollama / llama.cpp"]
EXT_TTS["TTS Providers"]
EXT_MCP["MCP Servers"]
EXT_BOT["QQ / Telegram / Discord / LINE / Webhook"]
end
FE_BRIDGE <--> IPC_INVOKE
IPC_INVOKE <--> BE_CMD
BE_MULTI <--> EXT_LLM
BE_MULTI <--> EXT_TTS
BE_MULTI <--> EXT_MCP
BE_BOT <--> EXT_BOT
BE_ORCH <--> DB
BE_CMD <--> CFG
- 前端：声明式布局、组件注册、主题系统、MOD UI 注入
- 后端：命令模块 + 多模态编排（LLM/TTS/STT/Vision/ImageGen/MCP）
- 数据层：以 SQLite 为底座构建本地优先记忆层，统一持久化角色、会话、摘要与长期记忆，并通过
embedding + FTS5 BM25 + RRF混合检索提供稳定长期上下文；梦境整理结合规则筛选、LLM 复核与定时/手动任务，对重复、冲突和可合并记忆进行持续治理。
详细设计见 docs/architecture.md。
- 跨平台稳定性与兼容性验证（Windows / Linux / macOS）
- 在线服务链路深度测试
- 记忆系统与多模态体验持续优化
- 角色市场 / 工坊
- 移动端支持探索（iOS / Android）
- 开发者扩展生态增强
欢迎通过以下方式参与：
- Pull Requests：修复问题或新增功能。
- Issues：提交问题与改进建议。
- Discussions：分享想法与实践。
- Design contributions：欢迎提供 Logo / 视觉资产。
👉 Kokoro Engine 官方讨论群（Telegram）
感谢所有为 Kokoro Engine 做出贡献的贡献者。
@aegbirou |
@Initsnow |
本项目核心代码遵循 MIT License。
本项目使用 Live2D Cubism SDK，相关部分归 Live2D Inc. 所有。使用本项目（包括编译、分发、修改）时，请遵守 Live2D 许可协议：
若您属于年营业额超过 1000 万日元的中大型企业，可能需要与 Live2D Inc. 签署单独商业授权协议。
本项目内置的默认模型 Hiyori Momose - PRO 来自 Live2D 官方样本数据。该样本模型的使用受 Live2D Free Material License Agreement 与样本数据条款约束：
版权信息：Illustration: Kani Biimu / Modeling: Live2D。请勿修改 Hiyori Momose 的角色设计。非一般用户或小规模企业用户使用时，请自行确认是否需要 Live2D Inc. 的额外许可。
Kokoro Engine is an open-source project. Live2D is a registered trademark of Live2D Inc.
