Open-LLM-VTuber 本地部署全记录3 条命令跑通会语音对话的 Live2D 虚拟形象【免费下载链接】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 是一个让本地大模型配上 Live2D 虚拟形象、用免提语音实时对话的开源项目。下面按「环境速查 → 部署主线 → 体验场景 → 踩坑速查」的顺序带你把它部署到能跑通为止。环境速查Python 3.10–3.12项目硬要求版本过旧装不上依赖已装 uv 包管理器和 git拉代码和前端 submodule 都要用它约 5GB 空闲磁盘语音模型会自动下载到项目目录部署主线阶段一跑起来git clone https://gitcode.com/GitHub_Trending/op/Open-LLM-VTuber cd Open-LLM-VTuber uv sync uv run run_server.py首次启动会打印日志并自动初始化前端等几分钟后访问http://127.0.0.1:12393即可。阶段二第一次见面页面加载完成后右侧是站在教室背景里的 Live2D 形象左上角显示 Connected 状态左侧是设置面板可以改语言、背景图和角色预设底部有麦克风按钮和输入框右下角还能直接打字。阶段三按喜好调整配置文件是项目根目录的conf.yaml首次启动会自动从 config_templates/ 拷出。换人设就改character_config.persona_prompt换形象就把live2d_model_name指到仓库里另一个模型可选mao_pro或shizuku。想建多个可切换的角色把配置放进 characters/ 目录即可界面上能直接选用。体验场景场景一纯语音对话对着麦克风说话SenseVoice 负责听写角色回答会一句句播出来形象跟着内容切换表情你随时开口插话当前回答会被打断不用戴耳机也不会被自己的声音干扰。场景二让它看见你的屏幕在侧栏开启屏幕共享界面会出现共享预览条。你正在看的文档、报错信息它都能看到并针对内容发表看法适合边写代码边让虚拟形象「围观」。场景三桌面宠物装上桌面客户端后虚拟形象以透明背景浮在桌面最上层可以拖到任意窗口旁边点击或拖动有触摸反馈相当于一个常驻屏幕的 AI 搭子。踩坑速查浏览器打开 404 → 前端 submodule 没拉下来回到终端执行git submodule update --init --recursive多半是网络问题导致 clone 时漏拉。麦克风按钮点不了 → 浏览器只允许在 localhost 或 HTTPS 下启用麦克风远程访问需配反向代理挂 HTTPS。AI 应声慢 → 默认 LLM 后端是 Ollama先在本地装好并ollama pull默认模型qwen2.5:latest再重启服务。首次启动卡住 → 正在自动下载 SenseVoice 语音模型到models/目录等它落盘即可之后启动可完全离线。依赖装了一堆 → 依赖里含 torch 等较大包建议留足 5GB 磁盘装完后uv sync会复用缓存。收尾下一步建议把live2d_model_name换成仓库里另一个模型对比效果或在conf.yaml里把 LLM 后端从 Ollama 改成 Claude、DeepSeek 之类的 API 服务省去本地推理的资源占用。【免费下载链接】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），仅供参考