echomimic

环境要求

• 操作系统：CentOS 7.2 或 Ubuntu 22.04（README 实测环境）
• CUDA >= 11.7，需 NVIDIA 显卡（实测 A100 80G / RTX4090D 24G / V100 16G）
• Python 3.8 / 3.10 / 3.11（README 推荐 conda 创建 Python 3.8 环境）
• 已安装 conda 与 pip

安装与启动步骤

1. 1克隆项目代码

   从 GitHub 拉取 EchoMimic 源码到本地，随后进入项目根目录准备后续操作。

   git clone https://github.com/antgroup/echomimic.git
   cd echomimic

   复制

2. 2创建 conda 环境

   README 推荐使用 conda 隔离环境，示例创建名为 echomimic 的 Python 3.8 环境并激活。

   conda create -n echomimic python=3.8
   conda activate echomimic

   复制

3. 3安装依赖包

   在激活的 echomimic 环境中，按 requirements.txt 一次性安装项目所需 Python 依赖。

   pip install -r requirements.txt

   复制

4. 4启动 Gradio 界面

   运行 webgui.py 启动网页交互界面，可通过 server_port 参数指定端口，默认示例为 3000。

   python -u webgui.py --server_port=3000

   复制

关键配置

如何确认成功

执行 webgui.py 后终端无报错，浏览器打开 http://localhost:3000 能看到 Gradio 操作界面即成功。

常见问题

注意事项

• README 节选未给出预训练模型权重的下载与推理脚本说明，实际使用前请补充查看官方仓库与 HuggingFace/ModelScope 模型页。
• 启动 Web UI 依赖 Gradio，首次运行可能需下载相关资源，请保持网络畅通。
• 建议在独立 conda 环境中安装，避免与系统 Python 包产生冲突。
• 官方同时提供 HuggingFace 与 ModelScope 的在线 Demo，可先在线体验再决定本地部署。