项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 14656
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Python 环境(项目基于 Python 构建)
- 一个可用的大语言模型后端(如 OpenAI、Claude 或本地模型)
- 可能需要 uv 作为 Python 依赖管理工具(README 卸载章节提到过)
- 可能需要 ffmpeg 等外部工具(README 卸载章节提到过)
安装与启动步骤
-
1阅读官方快速开始
README 未直接给出安装步骤,明确要求参考官方文档的 Quick Start 章节完成安装,请先打开该页面。
-
2克隆项目仓库
把源码下载到本地,仓库地址取自项目信息中的 GitHub 地址;后续所有配置和模型文件默认都放在该目录内。
git clone https://github.com/Open-LLM-VTuber/Open-LLM-VTuber.git -
3进入项目目录
切换到克隆下来的项目根目录,README 说明 Python 依赖与模型大多存放在此目录。
cd Open-LLM-VTuber -
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
同类项目推荐
Speech2Video
开源
输入一段语音,自动生成带3D姿态的说话人视频
ACCV 2020 "Speech2Video Synthesis with 3D Skeleton Regularization and Expressive Bod···
ChatdollKit
开源
让 3D 模型秒变能听会说的 AI 聊天角色
ChatdollKit enables you to make your 3D model into a chatbot
THREE.Terrain
开源
几行代码在网页里生成可交互的 3D 地形
A procedural terrain generation engine for use with the Three.js 3D graphics library···
Blend_My_NFTs
开源
用 Blender 批量生成数千个 3D 变体,一键搞定 NFT 系列
Easily generate thousands of 3D models, images, and animation automatically in Blend···
MeshAnything
开源
一键将任意3D数据转为艺术家级网格,告别杂乱拓扑
[ICLR 2025] From anything to mesh like human artists. Official impl. of "MeshAnythin···
CityDreamer4D
开源
从单图生成无限动态 4D 城市,用于仿真与创作
The official implementation of "Compositional Generative Model of Unbounded 4D Citie···
一张图+一段音频,生成会说话的角色头像视频
Avatar Generation For Characters and Game Assets Using Deep Fakes
DLRS
开源
把你备份成数字遗产,多年后仍能对话。
DLRS: Privacy-first digital life archive standard for consent governance, AI avatars···
instant-nvr
开源
几分钟内重建动态人体,快速生成神经体积表示。
[CVPR 2023] Code for "Learning Neural Volumetric Representations of Dynamic Humans i···
