handcrafted-persona-engine

用 Live2D 和 AI 打造会说话、能变声的虚拟形象，快速开播。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 161 🐛 待处理 8 👀 关注 18

GitHub ↗

GitHub 星标 ★ 1398

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，可自行部署，完全免费。

项目预览

handcrafted-persona-engine 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队elevenyellow

GitHubhttps://github.com/elevenyellow/handcrafted-persona-engine

定价模式🏷️完全免费

价格说明开源项目，可自行部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

主要语言C#

技术栈/模型ai,ai-vtuber,ai-waifu,chatbot,live2d,vtuber

GitHub 星标★ 1398

上线时间2025-03-28 00:00:00

代码更新2026-05-20

仓库体积72.4 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数6

项目介绍

这是一个基于 C# 的 AI 交互式虚拟形象引擎，整合了 Live2D 模型、大语言模型（LLM）、自动语音识别（ASR）、文本转语音（TTS）以及变声（RVC）技术。它主要解决 VTuber、直播主和虚拟助手场景中，如何快速构建一个具备视觉表现、语音交互和角色扮演能力的数字人。核心能力包括：通过 Live2D 实现角色动画与口型同步，利用 LLM 驱动角色对话与人格设定，结合 ASR/TTS 实现自然语音交互，并通过 RVC 进行实时变声以匹配角色音色。项目提供了模块化架构，支持自定义接入不同的 AI 服务，适合开发者二次开发。其目标是降低虚拟形象应用的门槛，让创作者无需从零搭建复杂的音视频管线。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1398

技术标签

ai ai-vtuber ai-waifu chatbot live2d

使用教程

难度：入门约 30 分钟部署方式：本地安装 8 步

环境要求

Windows x64 操作系统
NVIDIA GPU 且支持 CUDA（ASR/TTS/RVC 均通过 ONNX Runtime 跑在 CUDA 上，不支持 CPU/AMD/Intel）
约 16 GB 可用磁盘空间（模型会下载到 exe 同级的 Resources/ 目录）

安装与启动步骤

1下载发行包

从 GitHub Releases 页面下载名为 PersonaEngine-<version>-win-x64.zip 的压缩包，注意是 win-x64 版本。
2解压到剩余空间目录

解压到至少有 16 GB 空闲空间的目录，模型和 NVIDIA 运行时会放在 exe 同级的 Resources/ 文件夹里。
3启动引擎

双击 PersonaEngine.exe 启动，首次运行会弹出配置档选择提示。
```
PersonaEngine.exe
```
4选择安装配置档

在提示中选择 try（试玩）、stream（直播）或 build（开发/最高质量），随后模型与 NVIDIA 运行时会自动下载、校验哈希并安装。
5重新运行选择器

想换配置档或重走一遍向导时，加 --reinstall 参数重新启动引擎。
```
PersonaEngine.exe --reinstall
```
6跳过选择器指定档位

用 --profile 直接指定配置档跳过交互选择，可搭配 --non-interactive 让任何提示都变成报错退出。
```
PersonaEngine.exe --profile=stream --non-interactive
```
7校验与修复资源

--verify 只重新计算哈希并报告不匹配（不下载）；--repair 会重新下载所有未通过哈希校验的文件。
```
PersonaEngine.exe --verify
```
8开启高质量模型开关

选了 build 档还需在界面手动切换：Voice 面板设为 Expressive（Qwen3）、Listening 面板选 Accurate Whisper 模板、Avatar 面板开启 Audio2Face 口型同步。

关键配置

配置项	必填	说明	示例
`--profile`	否	跳过选择器直接使用指定配置档	`--profile=try`
`--offline`	否	禁止访问网络，资源缺失时快速失败	`--offline`
`--skip-gpu-check`	否	绕过 GPU 能力检查，官方不推荐使用	`--skip-gpu-check`
`Voice 模式`	否	build 档需手动切到 Expressive 才会启用 Qwen3 表达性语音	`Expressive`
`Listening 模板`	否	build 档需手动选 Accurate 的 Whisper 模板	`Accurate`
`Avatar 口型同步`	否	build 档需手动启用 Audio2Face 口型同步	`Audio2Face`

如何确认成功

双击 PersonaEngine.exe 后能正常弹出安装配置档选择提示，模型与 NVIDIA 运行时下载并哈希校验通过后引擎启动即成功。

常见问题

Q：AMD 或 Intel 显卡能用吗？

A：不能。ASR、TTS、RVC 全部通过 ONNX Runtime 依赖 CUDA 运行，README 明确说明不支持 CPU/AMD/Intel。

Q：从旧版（非安装器版）升级需要注意什么？

A：资源目录结构已变，旧的 Resources/Models/ 和 Resources/Live2D/Avatars/ 会被忽略，安装器首次启动会重新下载到新位置；请先腾出约 16 GB，等引导完成后删除旧文件夹。

Q：选了 build 档为什么效果还是轻量模型？

A：配置档只是下载更大的模型，UI 默认仍启用轻量模型。需要手动把 Voice 面板设为 Expressive（Qwen3）、Listening 面板选 Accurate Whisper、Avatar 面板开启 Audio2Face。

Q：下载的资源校验失败怎么办？

A：使用 PersonaEngine.exe --repair 重新下载所有未通过哈希校验的文件；--verify 只做校验和报告、不下载。

Q：没有网络时能启动吗？

A：可以加 --offline 参数，引擎会拒绝访问网络，如果资源缺失则直接快速失败。

注意事项

必须使用 NVIDIA GPU + CUDA 的 Windows x64 环境，其他平台无法运行。
准备至少 16 GB 空闲磁盘空间，模型默认下载到 exe 同级的 Resources/ 目录。
--skip-gpu-check 可以绕过 GPU 能力检查，但官方标注为不推荐。
更完整的界面配置流程见项目内 INSTALLATION.md。

核心亮点

整合了 Live2D、LLM、ASR、TTS、RVC 全套技术栈，开箱即用，避免多工具拼接麻烦
模块化设计，可灵活替换或接入不同的 AI 服务，适配性强
支持实时口型同步和变声，虚拟角色表现力自然，适合直播场景

不足之处

C# 技术栈对 Web 前端开发者不友好，上手门槛较高
文档和社区资源相对较少，遇到问题排查依赖自身能力

适用场景

VTuber 直播：让虚拟形象实时回应观众弹幕或语音
虚拟助手/客服：提供有形象、有声音的交互式服务
角色扮演聊天：创建具有独特人格的 AI 伴侣或游戏 NPC

替代项目

VTuber AI、Live2D View、AI Vtuber (Python 版)

上一篇：LLMUnity

下一篇：ChatdollKit