LivePortrait

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 可联网的本地环境，能克隆 GitHub 仓库
• 已安装 Python 与 pip，可执行 pip 安装命令
• 网络能访问 Hugging Face，否则需使用 hf-mirror 镜像
• 有足够磁盘空间存放 pretrained_weights 目录

安装与启动步骤

1. 1克隆项目代码

   拉取 LivePortrait 源码并进入项目目录，后续下载的预训练权重需放在项目根目录下。

   git clone https://github.com/KlingAIResearch/LivePortrait.git
   cd LivePortrait

   复制

2. 2安装下载工具

   安装 Hugging Face 命令行工具，用于拉取官方预训练权重。

   pip install -U "huggingface_hub[cli]"

   复制

3. 3下载预训练权重

   把官方权重下载到项目根目录的 pretrained_weights 目录，命令会自动排除 .git、README 和 docs。

   huggingface-cli download KlingTeam/LivePortrait --local-dir pretrained_weights --exclude "*.git*" "README.md" "docs"

   复制

4. 4国内镜像下载

   若无法访问 Hugging Face，先设置镜像端点，再执行同一条下载命令。

   export HF_ENDPOINT=https://hf-mirror.com
   huggingface-cli download KlingTeam/LivePortrait --local-dir pretrained_weights --exclude "*.git*" "README.md" "docs"

   复制

5. 5手动下载权重

   也可从 Google Drive 或百度云（提取码 z5cn）下载全部权重，解压后放入 ./pretrained_weights。

6. 6核对目录结构

   确认 pretrained_weights 目录内容与官方 assets/docs/directory-structure.md 描述的结构一致。

关键配置

如何确认成功

对照 assets/docs/directory-structure.md 检查 pretrained_weights 目录结构是否完整一致。

常见问题

注意事项

• 本次 README 节选只包含预训练权重下载说明，未给出依赖安装与推理运行命令，需查阅官方仓库获取。
• 下载命令中的 --exclude 会跳过 *.git*、README.md 和 docs，避免拉取无关文件。
• 使用镜像下载前必须先 export HF_ENDPOINT，否则仍会访问原站。
• 百度云链接提取码为 z5cn，下载后需手动解压到指定目录。