HY-Motion 1.0部署教程：NVIDIA NGC容器镜像快速拉取与运行

想不想用几句话就让3D角色动起来？比如输入“一个人从椅子上站起来，然后伸个懒腰”，就能立刻生成一段流畅自然的3D骨骼动画。这听起来像是未来科技，但现在，借助HY-Motion 1.0这个强大的文生3D动作模型，你完全可以做到。

HY-Motion 1.0是目前开源领域里非常先进的3D动作生成模型。它最大的特点就是“听话”和“效果好”。你只需要用简单的英文描述你想要的动作，它就能生成对应的、基于骨骼的3D动画数据，可以直接用在你的动画项目里。这对于游戏开发、影视预演、虚拟人驱动等需要大量动画内容的场景来说，简直是效率神器。

今天这篇教程，就是带你用最快、最省事的方法——通过NVIDIA NGC的预置容器镜像，把HY-Motion 1.0跑起来。你不需要操心复杂的Python环境、依赖冲突或者模型下载，跟着步骤走，十分钟内就能看到效果。

1. 环境准备：拥有一台带NVIDIA显卡的机器

要运行HY-Motion 1.0，你需要准备一台有NVIDIA显卡的电脑或服务器。这是最关键的一步。

1.1 硬件与系统要求

• 显卡（GPU）：这是核心。你需要一块NVIDIA显卡，并且显存至少要有24GB。这是因为模型本身比较大，运行需要足够的显存空间。
  • 推荐型号：NVIDIA RTX 4090 (24GB)、RTX 6000 Ada (48GB) 或性能更强的专业卡/服务器卡（如A100, H100）。
  • 轻量版选择：如果你只有一张24GB显存的卡，可以优先尝试运行 HY-Motion-1.0-Lite 这个轻量版模型，它对显存的要求相对友好。
• 操作系统：推荐使用 Ubuntu 20.04 或 22.04。这是最兼容、问题最少的Linux发行版。当然，其他Linux发行版理论上也可以，但可能需要自己解决一些依赖问题。
• 软件前提：确保你的系统已经安装了 Docker 和 NVIDIA Container Toolkit（以前叫nvidia-docker）。这是让Docker容器能使用你GPU的关键。

1.2 快速检查你的环境

在开始之前，打开你的终端，运行下面几个命令检查一下：

1. 检查显卡和驱动：

   nvidia-smi
   

   这个命令会显示你的GPU型号、驱动版本以及显存使用情况。确认驱动版本不要太旧。

2. 检查Docker：

   docker --version
   

3. 检查NVIDIA Container Toolkit：

   docker run --rm --gpus all nvidia/cuda:12.2.2-base-ubuntu22.04 nvidia-smi
   

   如果这个命令能成功运行并显示出和直接运行 nvidia-smi 类似的信息，说明你的Docker已经可以调用GPU了。

如果上面任何一步报错，你需要先搜索一下如何安装对应的软件。对于Ubuntu用户，安装命令通常很简单。

2. 拉取并运行NGC容器镜像

NVIDIA NGC是一个宝藏仓库，里面存放了很多官方优化好的AI应用容器镜像。HY-Motion 1.0的镜像也在里面，我们直接拉取运行就行，省去了自己配置环境的麻烦。

2.1 一步到位：拉取镜像并启动容器

这是最核心的一步。在终端中执行以下命令：

docker run --gpus all -it --rm -p 7860:7860 -v /path/to/your/output:/output nvcr.io/tencent/hunyuan/hy-motion-1.0:latest

我来解释一下这个命令的每个部分：

• docker run： 运行一个新的容器。
• --gpus all： 把宿主机的所有GPU都分配给这个容器使用。
• -it： 以交互模式运行，并分配一个伪终端，这样你可以看到日志。
• --rm： 当容器停止运行时，自动删除它。这可以保持系统清洁，但如果你需要保存容器状态，可以去掉这个参数。
• -p 7860:7860： 端口映射。将容器内部的7860端口映射到你电脑的7860端口。等下我们就是通过访问 http://localhost:7860 来打开网页界面的。
• -v /path/to/your/output:/output： 非常重要！ 这是数据卷挂载。/path/to/your/output 需要替换成你电脑上的一个真实路径（比如 /home/yourname/hy_motion_output）。容器里生成的动画文件会保存在 /output 目录，通过这个挂载，文件就会同步保存到你指定的本地文件夹里，防止容器删除后文件丢失。
• nvcr.io/tencent/hunyuan/hy-motion-1.0:latest： 这就是HY-Motion 1.0在NGC上的镜像地址。

第一次运行时，Docker会自动从NGC仓库下载这个镜像，可能会花几分钟时间，取决于你的网速。下载完成后，容器会自动启动，你会在终端看到一系列启动日志。

2.2 等待模型加载

容器启动后，它会自动开始加载HY-Motion模型。这个过程可能需要1-3分钟，因为模型有几十亿参数，需要从容器内加载到GPU显存中。

当你看到日志里出现类似 Running on local URL: http://0.0.0.0:7860 这样的信息时，就说明模型加载成功，Gradio网页服务已经启动好了。

3. 使用Gradio网页界面生成你的第一个3D动作

现在，打开你电脑上的浏览器，在地址栏输入：http://localhost:7860

如果一切顺利，你会看到一个简洁的网页界面。这就是HY-Motion 1.0的操作面板。

3.1 界面功能一览

界面通常包含以下几个部分：

1. 文本输入框 (Text Prompt)： 在这里输入描述动作的英文句子。
2. 生成按钮： 点击它，开始根据你的描述生成动作。
3. 结果展示区： 生成成功后，这里会显示一个可交互的3D视图。你可以用鼠标拖拽旋转视角，滚轮缩放，全方位查看生成的角色动画。
4. 参数选项 (可能折叠)： 有时会有一些高级选项，比如选择模型版本（标准版或Lite版）、设置随机种子、调整动作长度等。首次使用可以先用默认设置。

3.2 输入Prompt的技巧与案例

怎么描述动作，模型才能更好地理解呢？这里有几个小技巧：

• 使用英文： 目前模型对英文的理解更好。
• 描述要具体： 尽量描述身体部位的动作。比如，“A person walks”就不如“A person walks slowly with arms swinging naturally”来得具体。
• 避免描述外观和情绪： 模型专注于骨骼动作，它不理解“一个悲伤的、穿着红衣服的人跳舞”这种描述。请专注于动作本身。
• 参考案例：
  • A person performs a squat, then pushes a barbell overhead using the power from standing up. (一个人深蹲，然后利用站起的力量将杠铃推过头顶。)
  • A person climbs upward, moving up the slope. (一个人向上攀登，在斜坡上移动。)
  • A person stands up from the chair, then stretches their arms. (一个人从椅子上站起来，然后伸展手臂。)
  • A person walks unsteadily, then slowly sits down. (一个人走路不稳，然后慢慢坐下。)

3.3 开始生成！

让我们来试一下：

1. 在文本框中输入：A person waves hello with right hand. (一个人用右手挥手打招呼。)
2. 点击 Submit 或 Generate 按钮。
3. 等待片刻（生成时间从几秒到几十秒不等，取决于动作复杂度和你的GPU）。
4. 完成后，你就能在3D视图里看到一个骨骼角色在向你挥手了！你可以用鼠标与这个3D模型互动，从各个角度观察动作细节。

4. 进阶使用与问题排查

成功运行一次后，你可能想了解更多。

4.1 如何保存生成的动画？

还记得我们启动容器时挂载的目录吗 (-v /path/to/your/output:/output)？所有生成的动画文件（通常是 .fbx 或 .npy 格式）都会自动保存在你本地对应的 /path/to/your/output 文件夹里。你可以将这些文件直接导入到 Blender、Maya、Unity 或 Unreal Engine 等主流3D软件和游戏引擎中使用。

4.2 常见问题与解决

• 提示“端口7860被占用”： 可能是你之前运行过其他使用了7860端口的应用（比如另一个Gradio应用）。你可以修改命令中的端口映射，例如 -p 7861:7860，然后通过 http://localhost:7861 访问。
• 提示“CUDA out of memory” (显存不足)：
  • 首先确认你的显卡显存是否真的大于24GB。
  • 尝试运行轻量版模型 HY-Motion-1.0-Lite（如果界面有选项）。
  • 在启动命令中，可以尝试传递环境变量来限制显存使用或使用更小的批处理大小（具体参数需要参考镜像的文档或通过 --help 查看）。
• 生成的动作很奇怪或不听指令：
  • 检查你的Prompt是否遵循了规范（用英文，只描述动作）。
  • 尝试更简单、更直接的描述。
  • 换个随机种子（如果界面有Seed选项）重新生成，有时会有不同效果。
• 容器启动后无法访问网页：
  • 检查终端日志，确认服务是否真的启动成功 (Running on local URL...)。
  • 检查防火墙设置，是否屏蔽了7860端口。
  • 如果你是在远程服务器（没有图形界面）上运行，你需要通过SSH隧道将服务器的7860端口映射到本地才能访问。

5. 总结

通过这篇教程，你应该已经成功地在自己的机器上部署并运行了HY-Motion 1.0。我们来快速回顾一下关键步骤：

1. 准备环境：确保有一台配备24GB以上显存NVIDIA显卡的电脑，并安装好Docker和NVIDIA驱动。
2. 一键运行：使用一条 docker run 命令，从NVIDIA NGC拉取镜像并启动容器，记得挂载一个本地目录用来保存生成的文件。
3. 网页交互：在浏览器打开 localhost:7860，用英文描述你想要的3D动作，点击生成。
4. 查看与使用：在网页中交互式查看3D动画，并在你挂载的本地文件夹中找到生成的动画文件，用于后续的3D创作流程。

HY-Motion 1.0将文本生成3D动作的门槛降到了前所未有的低点。无论是为独立游戏快速制作NPC动画，还是为视频项目预演角色运动，它都能成为一个强大的生产力工具。现在，你可以尽情发挥创意，用文字驱动你的3D世界了。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。