Open-LLM-VTuber AI 虚拟主播10 分钟零基础的离线部署路线【免费下载链接】Open-LLM-VTuberTalk to any LLM with hands-free voice interaction, voice interruption, and Live2D avatar running locally across platforms项目地址: https://gitcode.com/GitHub_Trending/op/Open-LLM-VTuberOpen-LLM-VTuber 是一个完全在本地运行的语音交互 AI 虚拟主播Live2D 形象、实时语音对话、视觉感知全部离线跑在你的电脑上对话数据不离开本机。跟着本文操作你可以从零把它部署起来打开浏览器就用语音和 AI 角色聊天。⚙️ 部署前只需检查这三样Python 3.10–3.12项目要求3.10,3.13用uv安装依赖时它会自动处理版本无需手动装 Python 环境。Ollama 服务默认配置的大语言模型后端是 Ollama模型qwen2.5启动前需要装好 Ollama 并执行ollama pull qwen2.5你也可以改配置换用 OpenAI 兼容 API 等其他后端。磁盘空间依赖包和语音模型会下载到项目目录内建议预留 5GB 以上。 跑通核心流程克隆项目代码把仓库拉到本地前端界面是一个 Git 子模块首次启动服务时会自动初始化克隆时不用额外处理。git clone https://gitcode.com/GitHub_Trending/op/Open-LLM-VTuber cd Open-LLM-VTuber确认成功目录里能看到run_server.py和config_templates/。用 uv 安装依赖uv sync会按锁文件把全部依赖装进独立虚拟环境语音识别、语音合成、Web 服务等一次装齐。uv sync确认成功命令跑完无报错项目下生成.venv目录。复制一份默认配置配置文件决定用哪个 LLM、ASR、TTS。中文用户建议直接复制中文预设版里面预置了中文语音音色英文版用config_templates/conf.default.yaml。即使不复制首次启动时服务也会自动从模板生成一份conf.yaml。cp config_templates/conf.ZH.default.yaml conf.yaml确认成功项目根目录出现conf.yaml。启动服务服务是 FastAPI WebSocket 结构启动时会加载配置、初始化语音模型然后监听端口。uv run run_server.py确认成功终端出现Starting server on localhost:12393浏览器访问http://localhost:12393就能看到 Live2D 形象界面。 上手后的功能体验实时语音对话打开页面后点击麦克风按钮说话角色边听边想边回答支持你随时插话打断AI 不会听到自己的声音。视觉感知开启屏幕共享或摄像头AI 就能看到你的屏幕内容你可以问它屏幕上正在显示什么。桌宠模式桌面客户端支持透明背景、全局置顶和鼠标穿透可以把 AI 伴侣拖到屏幕任意位置让它常驻陪伴。 个性化配置改哪里全局配置在项目根目录的conf.yaml改asr_config、tts_config、llm_configs即可切换识别、合成和对话引擎改完重启服务生效。多角色管理放在characters/目录每个 yaml 文件只写你要改的项人设、音色、模型其余自动继承conf.yaml前端界面里可以直接运行时切换。想加新的 Live2D 模型把模型文件夹放进live2d-models/再在model_dict.json里登记名称即可。⚠️ 容易踩的坑浏览器打开是空白或提示Not Found→ 前端子模块没初始化成功重启uv run run_server.py会自动执行git submodule update --init --recursive仍失败就手动跑一次这条命令。角色只动嘴不出声或回答很慢 → 多半是 Ollama 没跑起来或没拉取qwen2.5模型先单独确认 Ollama 能正常对话。完全离线环境下语音合成失败 → 默认 TTS 是edge_tts需要联网换成tts_config里的sherpa_onnx_tts等本地方案。收束从克隆代码到浏览器里和 AI 角色说话整条路径就是克隆 →uv sync→ 复制conf.yaml→uv run run_server.py。下一步建议先在characters/里照着现有预设复制一份角色文件改一句人设体验定制效果。遇到问题优先看仓库 README 里列出的常见问题文档或进项目社区群提问通常都有人踩过同样的坑。【免费下载链接】Open-LLM-VTuberTalk to any LLM with hands-free voice interaction, voice interruption, and Live2D avatar running locally across platforms项目地址: https://gitcode.com/GitHub_Trending/op/Open-LLM-VTuber创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
