{"id":47292696,"url":"https://github.com/chyinan/kokoro-engine","last_synced_at":"2026-05-11T10:04:12.233Z","repository":{"id":338727394,"uuid":"1158889536","full_name":"chyinan/Kokoro-Engine","owner":"chyinan","description":"Cross-platform virtual character immersive interaction engine","archived":false,"fork":false,"pushed_at":"2026-05-07T12:35:56.000Z","size":113488,"stargazers_count":73,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T14:39:11.156Z","etag":null,"topics":["ai","custom","engine","live2d","llm","mcp","mod","neuro-sama","pixijs","rust","shadcn-ui","sqlite","stt","tailwindcss","tauri","tts"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chyinan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-16T03:35:37.000Z","updated_at":"2026-05-07T12:36:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chyinan/Kokoro-Engine","commit_stats":null,"previous_names":["chyinan/kokoro-engine"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/chyinan/Kokoro-Engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyinan%2FKokoro-Engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyinan%2FKokoro-Engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyinan%2FKokoro-Engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyinan%2FKokoro-Engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chyinan","download_url":"https://codeload.github.com/chyinan/Kokoro-Engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyinan%2FKokoro-Engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32889972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai","custom","engine","live2d","llm","mcp","mod","neuro-sama","pixijs","rust","shadcn-ui","sqlite","stt","tailwindcss","tauri","tts"],"created_at":"2026-03-16T10:08:24.223Z","updated_at":"2026-05-11T10:04:12.228Z","avatar_url":"https://github.com/chyinan.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"README.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"README_ZH-TW.md\"\u003e繁體中文\u003c/a\u003e | \u003ca href=\"README_EN.md\"\u003eEnglish\u003c/a\u003e | \u003ca href=\"README_JA.md\"\u003e日本語\u003c/a\u003e | \u003ca href=\"README_KO.md\"\u003e한국어\u003c/a\u003e | \u003ca href=\"README_RU.md\"\u003eРусский\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"pictures/Poster_Girl.png\" alt=\"Kokoro Engine banner\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eKokoro Engine\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003eOpen-source immersive character engine for desktop AI companions.\u003c/strong\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e为每一位想拥有专属AI聊天伴侣的用户打造的跨平台虚拟角色交互引擎。\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://t.me/+U39dgiUspCo2NDNh\"\u003e\u003cimg src=\"https://img.shields.io/badge/Telegram-Community-26A5E4?logo=telegram\u0026logoColor=white\" alt=\"Telegram community\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tauri-v2-24C8DB?logo=tauri\u0026logoColor=white\" alt=\"Tauri v2\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/React-18%2B-20232A?logo=react\u0026logoColor=61DAFB\" alt=\"React\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Rust-Stable-000000?logo=rust\u0026logoColor=white\" alt=\"Rust\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-2EA44F\" alt=\"MIT License\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-快速开始\"\u003e快速开始\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/chyinan/Kokoro-Engine/releases\"\u003e下载安装\u003c/a\u003e ·\n  \u003ca href=\"#-技术架构\"\u003e架构\u003c/a\u003e ·\n  \u003ca href=\"#-参与贡献\"\u003e贡献\u003c/a\u003e\n\u003c/p\u003e\n\n\n\n---\n\n##  Kokoro Engine 的独到之处\n\nKokoro Engine 不是“聊天壳子 + 桌宠皮肤”。它是一个完整的桌面角色运行时：\n\n- **All-in-one**：Live2D、LLM、TTS、STT等技术集成在一个运行时闭环。\n- **Built for extensibility**：高自由度 MOD 系统 + MCP 协议，天然面向扩展。\n- **Local-first**：本地存储记忆、离线优先、数据链路可控。\n\n## 一览\n\n| 维度 | 内容 |\n|---|---|\n| 面向用户 | 虚拟角色创作者、开发者、普通用户 |\n| 交互能力 | 文本、语音、图片、视觉输入、多模态对话 |\n| 扩展方式 | MOD（HTML/CSS/JS + QuickJS）、MCP Servers |\n| 技术栈 | React + TypeScript + Rust + Tauri v2 + SQLite |\n| 语言支持 | 简体中文 / 繁體中文 / English / 日本語 / 한국어 / Русский |\n\n## 📸 UI截图\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"pictures/Homepage.png\" alt=\"Homepage\" width=\"800\" /\u003e\n  \u003cp\u003e\u003cem\u003e主界面\u003c/em\u003e\u003c/p\u003e\n  \u003cimg src=\"pictures/Settings.png\" alt=\"Settings\" width=\"800\" /\u003e\n  \u003cp\u003e\u003cem\u003e设置界面\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 🚀 快速开始\n\n### 路径一：下载发布版（推荐）\n\n前往 [Releases 页面](https://github.com/chyinan/Kokoro-Engine/releases) 下载对应平台安装包后直接运行。\n\n### 路径二：从源码构建\n\n#### 环境要求\n\n- [Node.js](https://nodejs.org/)（v18+）\n- [Rust](https://www.rust-lang.org/tools/install)（stable）\n\n#### 安装与运行\n\n```bash\ngit clone https://github.com/chyinan/kokoro-engine.git\ncd kokoro-engine\nnpm install\nnpm run tauri dev\n```\n\n#### 构建发行版\n\n```bash\nnpm run tauri build\n```\n\n### 路径三：Nix / Flakes（仅 Linux）\n\n```bash\nnix develop\nnpm install\nnpm run tauri dev\n```\n\n更多 Nix 用法见 [docs/nix.md](docs/nix.md)。\n\n## ✨ 核心能力\n\n### 交互引擎\n\n- Live2D 渲染、视线追踪、动作触发、桌面浮窗\n- 模型热切换、帧率自定义\n\n### 多维架构\n\n- 支持 Ollama 、llama.cpp 与 OpenAI 、Anthropic 兼容协议API接口\n- 支持多模态输入、上下文回溯、长期记忆与情感状态\n\n### 音频交互\n\n- TTS（文本转语音）：GPT-SoVITS、VITS、OpenAI、Azure、ElevenLabs、Edge TTS、Browser TTS\n- STT（语音转文本）：Whisper / faster-whisper / whisper.cpp / SenseVoice\n- 支持 VAD 自动停录与唤醒词链路\n\n### 可拓展性\n\n- MOD 框架：HTML/CSS/JS 超高自由度 UI 主题替换 + QuickJS 脚本沙箱\n- MCP 支持：连接 MCP Server 并调用外部工具\n- 内置官方示范 MOD：`mods/genshin-theme`\n\n### 远程连接\n\n- 内置 Telegram Bot 服务\n- 文字、语音、图片消息完整桥接到 AI 管线流\n\n## 🏗️ 技术架构\n\n```mermaid\nflowchart LR\n  subgraph FE[\"Frontend (React + TypeScript)\"]\n    FE_UI[\"UI Layout Engine\"]\n    FE_REG[\"Component Registry\"]\n    FE_THEME[\"Theme \u0026 MOD UI\"]\n    FE_BRIDGE[\"kokoro-bridge.ts\"]\n    FE_UI --\u003e FE_REG\n    FE_REG --\u003e FE_THEME\n    FE_THEME --\u003e FE_BRIDGE\n  end\n\n  subgraph IPC[\"Tauri Typed IPC\"]\n    IPC_INVOKE[\"invoke / events\"]\n  end\n\n  subgraph BE[\"Backend (Rust / Tauri v2)\"]\n    BE_CMD[\"Commands Layer\"]\n    BE_ORCH[\"AI Orchestrator\"]\n    BE_MULTI[\"LLM / TTS / STT / Vision / ImageGen / MCP\"]\n    BE_MOD[\"MOD Runtime (QuickJS)\"]\n    BE_TG[\"Telegram Bridge\"]\n    BE_CMD --\u003e BE_ORCH\n    BE_ORCH --\u003e BE_MULTI\n    BE_MOD --\u003e BE_CMD\n    BE_TG --\u003e BE_CMD\n  end\n\n  subgraph DATA[\"Data \u0026 Runtime Config\"]\n    DB[(\"SQLite: memories / summaries / conversations / characters\")]\n    CFG[\"Config Files: llm/tts/stt/vision/imagegen/mcp/telegram\"]\n  end\n\n  subgraph EXT[\"External Services\"]\n    EXT_LLM[\"OpenAI-Compatible / Ollama / llama.cpp\"]\n    EXT_TTS[\"TTS Providers\"]\n    EXT_MCP[\"MCP Servers\"]\n    EXT_TG[\"Telegram\"]\n  end\n\n  FE_BRIDGE \u003c--\u003e IPC_INVOKE\n  IPC_INVOKE \u003c--\u003e BE_CMD\n\n  BE_MULTI \u003c--\u003e EXT_LLM\n  BE_MULTI \u003c--\u003e EXT_TTS\n  BE_MULTI \u003c--\u003e EXT_MCP\n  BE_TG \u003c--\u003e EXT_TG\n\n  BE_ORCH \u003c--\u003e DB\n  BE_CMD \u003c--\u003e CFG\n```\n\n- 前端：声明式布局、组件注册、主题系统、MOD UI 注入\n- 后端：命令模块 + 多模态编排（LLM/TTS/STT/Vision/ImageGen/MCP）\n- 数据层：以 SQLite 为底座构建本地优先记忆层，统一持久化角色、会话、摘要与长期记忆，并通过 `embedding + FTS5 BM25 + RRF` 混合检索提供稳定长期上下文；梦境整理结合规则筛选、LLM 复核与定时/手动任务，对重复、冲突和可合并记忆进行持续治理。\n\n详细设计见 [docs/architecture.md](docs/architecture.md)。\n\n## 🗺️ 路线图\n\n### 现在\n\n- 跨平台稳定性与兼容性验证（Windows / Linux / macOS）\n- 在线服务链路深度测试\n- 记忆系统与多模态体验持续优化\n\n### 下一步\n\n- 角色市场 / 工坊\n- 移动端支持探索（iOS / Android）\n- 开发者扩展生态增强\n\n## 🤝 参与贡献\n\n欢迎通过以下方式参与：\n\n1. **Pull Requests**：修复问题或新增功能。\n2. **Issues**：提交问题与改进建议。\n3. **Discussions**：分享想法与实践。\n4. **Design contributions**：欢迎提供 Logo / 视觉资产。\n\n## 💬 社区\n\n👉 [**Kokoro Engine 官方讨论群（Telegram）**](https://t.me/+U39dgiUspCo2NDNh)\n\n## ❤️ 赞助\n\n👉 [**查看赞助方式 / Sponsor**](SPONSOR.md)\n\n\n## 🎉 特别鸣谢\n\n感谢所有为 Kokoro Engine 做出贡献的贡献者。\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://github.com/aegbirou\"\u003e\n        \u003cimg src=\"https://github.com/aegbirou.png?size=120\" alt=\"@aegbirou\" width=\"88\" height=\"88\" /\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e@aegbirou\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://github.com/Initsnow\"\u003e\n        \u003cimg src=\"https://avatars.githubusercontent.com/u/79002121?s=96\u0026v=4\" alt=\"@Initsnow\" width=\"88\" height=\"88\" /\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003csub\u003e@Initsnow\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n## 📄 许可协议\n\n本项目核心代码遵循 **MIT License**。\n\n### ⚠️ Live2D Cubism SDK 声明\n\n本项目使用 **Live2D Cubism SDK**，相关部分归 Live2D Inc. 所有。使用本项目（包括编译、分发、修改）时，请遵守 Live2D 许可协议：\n\n- [Live2D Proprietary Software License Agreement](https://www.live2d.com/eula/live2d-proprietary-software-license-agreement_en.html)\n- [Live2D Open Software License Agreement](https://www.live2d.com/eula/live2d-open-software-license-agreement_en.html)\n\n\u003e 若您属于年营业额超过 1000 万日元的中大型企业，可能需要与 Live2D Inc. 签署单独商业授权协议。\n\n### ⚠️ 内置 Live2D 样本模型声明\n\n本项目内置的默认模型 **Hiyori Momose - PRO** 来自 Live2D 官方样本数据。该样本模型的使用受 Live2D Free Material License Agreement 与样本数据条款约束：\n\n- [Live2D Sample Data](https://www.live2d.com/en/learn/sample/)\n- [Live2D Sample Model Terms](https://www.live2d.com/en/learn/sample/model-terms/)\n\n版权信息：Illustration: Kani Biimu / Modeling: Live2D。请勿修改 Hiyori Momose 的角色设计。非一般用户或小规模企业用户使用时，请自行确认是否需要 Live2D Inc. 的额外许可。\n\n---\n\n**Kokoro Engine** is an open-source project.\nLive2D is a registered trademark of Live2D Inc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchyinan%2Fkokoro-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchyinan%2Fkokoro-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchyinan%2Fkokoro-engine/lists"}