准备工作：你需要什么

在开始之前，确保你的电脑满足基本条件：

• 操作系统：Windows、macOS 或 Linux 均可
• 至少 8GB 内存（推荐 16GB）
• 一个麦克风和扬声器（笔记本自带即可）
• 安装 Python 3.10 或更高版本（一种编程语言运行环境，用来运行程序）
• 安装 Git（版本管理工具，用来下载代码）

如果你还没装 Python 和 Git，可以去官网下载安装包，一路默认选项即可。

第一步：下载项目

1. 打开终端（Windows 按 Win+R，输入 cmd；Mac 打开“终端”应用）。
2. 输入以下命令，下载项目代码：
   git clone https://github.com/Open-LLM-VTuber/Open-LLM-VTuber.git
3. 进入项目文件夹：
   cd Open-LLM-VTuber

第二步：安装依赖

项目需要一些 Python 库才能运行，执行以下命令自动安装：

1. 创建虚拟环境（推荐，避免与其他项目冲突）：
   python -m venv venv
2. 激活虚拟环境：
   • Windows: venv\Scripts\activate
   • Mac/Linux: source venv/bin/activate
3. 安装依赖：
   pip install -r requirements.txt

第三步：配置并启动

你需要一个 本地大语言模型（LLM）（一种能理解并生成文字的 AI 模型），这里推荐用 Ollama（一个方便管理本地模型的工具）。

1. 下载并安装 Ollama（访问 ollama.com，选择对应系统版本）。
2. 打开终端，运行以下命令下载一个轻量模型（qwen2.5:7b 约 4GB，首次运行需联网）：
   ollama pull qwen2.5:7b
3. 回到项目文件夹，找到 conf.yaml 文件，用记事本打开。确保 llm_backend 设置为 ollama_llm，model 为 qwen2.5:7b。
4. 在终端中运行：
   python app.py

第四步：验证是否成功

1. 打开浏览器，访问 http://localhost:12393。
2. 点击页面上的“允许”按钮，授权麦克风权限。
3. 对着麦克风说话，比如“你好”，你应该能看到一个 Live2D 角色（一个会动的二次元形象）开口回应你。
4. 如果角色没有声音或没有反应，检查 conf.yaml 中的 tts_backend（文字转语音模块）设置，默认是 sherpa_onnx_tts，如果不行可以换成 edge_tts（需要联网）。

恭喜！你已经成功运行了一个本地 AI 语音助手。现在你可以自由对话，角色会根据情绪做出表情。想进一步探索？试试修改 conf.yaml 切换不同的 LLM 或语音模型，或者将角色窗口设为“桌面宠物模式”（在项目 Release 页面下载 Electron 客户端）。