MOVA

环境要求

• Python 3.13（conda 环境 mova）
• 已安装并可使用 conda
• 已安装 ComfyUI，存在 ComfyUI/custom_nodes 目录
• 首次运行需联网，从 HuggingFace 自动下载模型权重

安装与启动步骤

1. 1创建 conda 环境

   新建名为 mova 的独立环境，指定 Python 3.13，避免与系统环境冲突。

   conda create -n mova python=3.13 -y

   复制

2. 2激活环境

   后续所有安装与运行命令都要在这个已激活的环境中执行。

   conda activate mova

   复制

3. 3安装 MOVA

   在 MOVA 仓库根目录执行该命令，以可编辑方式安装项目及其依赖。

   pip install -e .

   复制

4. 4进入节点目录

   切换到 ComfyUI 的自定义节点目录，为安装 MOVA 节点做准备。

   cd ComfyUI/custom_nodes

   复制

5. 5克隆节点仓库

   递归克隆 comfyui-mova 节点仓库，--recursive 用于一并拉取子模块。

   git clone --recursive https://github.com/richservo/comfyui-mova.git

   复制

6. 6安装节点依赖

   进入克隆下来的目录并安装其 requirements.txt 中的依赖包。

   cd comfyui-mova
   pip install -r requirements.txt

   复制

如何确认成功

在 ComfyUI 中加载并使用 MOVA 节点，首次使用会自动从 HuggingFace 下载模型；能正常下载并完成一次生成即表示部署成功。

常见问题

注意事项

• pip install -e . 必须在 MOVA 仓库根目录执行，不要在 ComfyUI 目录下执行。
• ComfyUI 节点来自第三方仓库 richservo/comfyui-mova，其版本与主仓库可能不同步。
• MOVA 还提供 LoRA 微调与评测流程，具体用法参见 README 对应章节。
• 项目仍在成长阶段，文档与社区支持尚在建设中，遇到问题可加入 Discord 或飞书交流。