handcrafted-persona-engine

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

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

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1372
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队elevenyellow
所属国家
官网地址
定价模式free
价格说明开源项目,可自行部署,完全免费。
访问状态
是否开源是
开源协议
主要语言C#
技术栈/模型ai,ai-vtuber,ai-waifu,chatbot,live2d,vtuber
GitHub 星标★ 1372
30天Star增速
HF 下载量
上线时间2025-03-28 00:00:00
最近更新2026-09-23 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

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

环境要求

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

安装与启动步骤

  1. 1下载发行包

    从 GitHub Releases 页面下载名为 PersonaEngine--win-x64.zip 的压缩包,注意是 win-x64 版本。

  2. 2解压到剩余空间目录

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

  3. 3启动引擎

    双击 PersonaEngine.exe 启动,首次运行会弹出配置档选择提示。

    PersonaEngine.exe
  4. 4选择安装配置档

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

  5. 5重新运行选择器

    想换配置档或重走一遍向导时,加 --reinstall 参数重新启动引擎。

    PersonaEngine.exe --reinstall
  6. 6跳过选择器指定档位

    用 --profile 直接指定配置档跳过交互选择,可搭配 --non-interactive 让任何提示都变成报错退出。

    PersonaEngine.exe --profile=stream --non-interactive
  7. 7校验与修复资源

    --verify 只重新计算哈希并报告不匹配(不下载);--repair 会重新下载所有未通过哈希校验的文件。

    PersonaEngine.exe --verify
  8. 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 版)

项目介绍

handcrafted-persona-engine 是数字人3D领域的开源项目,由 elevenyellow 开发,2025 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,372)位列前 30%,在数字人3D分类的 272 个项目里位列前 15%。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-23。可自行部署,完全免费。

它主要面向的使用场景是:VTuber直播:让虚拟形象实时回应观众弹幕或语音。同类可对比的替代方案包括 VTuber AI、Live2D View、AI Vtuber (Python 版)。

上一篇:LLMUnity

下一篇:ChatdollKit

同类项目推荐

A3D 开源

在 three.js 里直接调用 AI 生成纹理和素材,边建模边生成

3D x AI hybrid editor, built with three.js

★ 129 2026-08-09
cube 开源

用一句话生成 3D 模型,在 Roblox 里快速落地 AI 创作

Roblox Foundation Model for 3D Intelligence

★ 1254 2026-08-09
AG3D 开源

用2D图片直接生成3D虚拟人,告别昂贵扫描

Official code release for ICCV2023 paper AG3D: Learning to Generate 3D Avatars from ···

★ 272 2026-08-09
GameFactory-3A 开源

一条命令生成 3A 游戏资产,从模型到视频全自动

A comprehensive open-source 3A game-generation skill and asset framework.

★ 798 2026-08-21