PersonaLive

环境要求

• Python 环境与 pip（README 以 pip 安装依赖）
• Node.js 18+（Web UI 需要，用 nvm 安装）
• Conda（安装 PyCUDA 时使用，避免编译问题）
• 使用 TensorRT 加速时需按 requirements_trt.txt 额外安装依赖

安装与启动步骤

1. 1安装基础依赖

   在项目根目录执行，安装运行 PersonaLive 所需的 Python 基础依赖包，需保证 pip 可正常联网下载。

   pip install -r requirements_base.txt

   复制

2. 2安装 Node.js 18

   Web UI 需要 Node.js 18+，README 给出用 nvm 安装的方式：先装 nvm，再安装 18 版本。

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   nvm install 18

   复制

3. 3启动 Web UI

   在项目目录下执行 README 提供的 web_start.sh 脚本启动网页界面，需已装好 Node.js 18 与基础依赖。

   source web_start.sh

   复制

4. 4安装 TensorRT 依赖

   需要 TensorRT 加速时执行，安装对应的 Python 依赖包；普通使用可跳过此步。

   pip install -r requirements_trt.txt

   复制

5. 5用 Conda 装 PyCUDA

   README 建议用 Conda 安装 PyCUDA 以避免编译问题，同时把 numpy 限定在 2.0 以下。

   conda install -c conda-forge pycuda "numpy<2.0"

   复制

6. 6安装训练依赖

   仅在需要自行训练时执行，安装训练专用的额外 Python 包。

   pip install -r requirements_train.txt

   复制

7. 7配置多卡训练

   使用多 GPU 或多节点训练前，先运行一次 Accelerate 配置向导，按提示填写硬件环境。

   accelerate config

   复制

如何确认成功

README 未给出明确的成功提示，执行 source web_start.sh 后无报错、终端输出服务地址即视为 Web UI 启动成功。

常见问题

注意事项

• README 未提供 git clone 命令，请自行获取项目源码后再执行上述安装步骤。
• 模型权重通过 Hugging Face（huaichang/PersonaLive）或 ModelScope（huaichang/PersonaLive）获取。
• 安装 PyCUDA 时务必保持 numpy<2.0，避免版本冲突。
• README 提到已有更新版本 EditaLive，支持全身动画与编辑能力，可按需关注。