Open-LLM-VTuber

对着电脑说话,Live2D 角色替你回答,支持打断,全本地运行。

Open-LLM-VTuber 是一个跨平台的开源语音交互助手,让你通过语音与任意大语言模型(LLM)对话,并配有 Live2D 虚拟形象。它解决了传统 LLM 聊天需要打字、缺乏沉浸感的问题,实现了免提语音交互、语音打断和实时面部动画。核心能力包括:本地运行(保护隐私)、支持多种 LLM 后端(如 OpenAI、Claude、本地模型)、语音识别与合成(支持多种 TTS/STT 引擎)、Live2D 模型驱动(根据语音和文本生成面部表情和口型)。项目基于 Python 构建,易于扩展和定制,适合开发者和爱好者打造个性化的虚拟助手或直播角色。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 13877
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队Open-LLM-VTuber
所属国家
定价模式free
价格说明开源项目,本地部署,完全免费
访问状态
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai,ai-companion,ai-vtuber,ai-waifu,chatbots,live2d,live2d-web,llm,neuro-sama,ollama
GitHub 星标★ 13877
30天Star增速
HF 下载量
上线时间2023-11-24 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数7

使用教程

难度:进阶 约 30 分钟 部署方式:本地安装 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境(项目基于 Python 构建)
  • 一个可用的大语言模型后端(如 OpenAI、Claude 或本地模型)
  • 可能需要 uv 作为 Python 依赖管理工具(README 卸载章节提到过)
  • 可能需要 ffmpeg 等外部工具(README 卸载章节提到过)

安装与启动步骤

  1. 1阅读官方快速开始

    README 未直接给出安装步骤,明确要求参考官方文档的 Quick Start 章节完成安装,请先打开该页面。

  2. 2克隆项目仓库

    把源码下载到本地,仓库地址取自项目信息中的 GitHub 地址;后续所有配置和模型文件默认都放在该目录内。

    git clone https://github.com/Open-LLM-VTuber/Open-LLM-VTuber.git
  3. 3进入项目目录

    切换到克隆下来的项目根目录,README 说明 Python 依赖与模型大多存放在此目录。

    cd Open-LLM-VTuber
  4. 4按文档安装依赖并启动

    README 未提供具体依赖安装与启动命令,请严格按照官方 Quick Start 文档执行,不要照抄其他来源的命令。

关键配置

配置项必填说明示例
MODELSCOPE_CACHE否ModelScope 下载的模型可能存放的缓存目录,卸载或迁移时需检查。/your/path/modelscope
HF_HOME否Hugging Face 下载的模型可能存放的缓存目录,卸载或迁移时需检查。/your/path/huggingface

如何确认成功

README 未给出启动验证方法,请以官方 Quick Start 文档中的访问页面与语音对话测试为准。

常见问题

Q:项目怎么安装?

A:README 没有写安装步骤,只指向官方文档的 Quick Start 章节(https://open-llm-vtuber.github.io/docs/quick-start),请以该文档为准。

Q:v1 还能提新功能需求吗?

A:不能。项目正在重写 v2.0 且处于早期规划阶段,官方请求不要在 v1 上开新功能 issue 或 PR,只是继续修 bug 和处理已有 PR。

Q:卸载后磁盘空间没释放?

A:除项目文件夹外,通过 ModelScope 或 Hugging Face 下载的模型可能残留在 MODELSCOPE_CACHE 或 HF_HOME 目录,需手动检查清理。

Q:想参与 v2.0 开发怎么办?

A:加入官方 Zulip 开发者社区(https://olv.zulipchat.com)参与讨论,每周会议安排会在 Zulip 上公布。

注意事项

  • 项目处于早期阶段并仍在活跃开发中,接口和用法可能变化,请以官方文档为准。
  • README 未提供任何安装命令、端口或配置文件说明,本教程中相关步骤仅作准备动作,不构成安装指导。
  • v1 目前只接受 bug 修复,新功能需求请等 v2.0。
  • 本项目自带 Live2D 虚拟形象与语音交互,涉及大模型 API 时请注意密钥与隐私安全。

核心亮点

  • 支持语音打断,对话更自然流畅
  • 跨平台(Windows/macOS/Linux),本地运行保护隐私
  • 灵活对接多种 LLM(OpenAI、Claude、本地模型等)

不足之处

  • 配置流程较复杂,需手动安装多个依赖
  • 语音识别和合成延迟可能较高,影响体验

适用场景

  • 个人桌面虚拟助手,语音问答
  • 直播互动,虚拟主播实时回复弹幕
  • 无障碍场景,为行动不便者提供语音交互

替代项目

Fay、VirtualWife、LobeChat

项目介绍

Open-LLM-VTuber 是数字人3D领域的开源项目,由 Open-LLM-VTuber 开发,2023 年首次发布。

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

近 41 天,它的 GitHub 星标从 13,207 增加到 13,877,净增 670。

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

它主要面向的使用场景是:个人桌面虚拟助手,语音问答。同类可对比的替代方案包括 Fay、VirtualWife、LobeChat。

上一篇:WeClone

下一篇:respace

同类项目推荐

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