MotionDirector

上传参考视频，用文本定制生成专属动作视频

开源 🏷️完全免费 ✅ 目前可打开视频生成 🍴 复刻 62 🐛 待处理 26 👀 关注 27

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1063

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，提供在线演示页面，可免费体验，代码开源，无付费版本。

项目预览

MotionDirector 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类视频生成

开发团队showlab

官网地址https://showlab.github.io/MotionDirector

GitHubhttps://github.com/showlab/MotionDirector

定价模式🏷️完全免费

价格说明开源项目，提供在线演示页面，可免费体验，代码开源，无付费版本。

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型diffusion-models,motion-customization,text-to-motion,text-to-video,text-to-video-generation,video-generation

GitHub 星标★ 1063

上线时间2023-10-12 00:00:00

代码更新2024-08-21

仓库体积181.6 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数1

项目介绍

MotionDirector 是 ECCV 2024 Oral 论文的开源实现，专注于文本到视频扩散模型的运动定制。它解决的是现有视频生成模型难以精确控制动作、只能生成通用运动的问题。核心能力包括：通过双路径 LoRA（空间路径和时间路径）解耦外观与运动学习，支持单视频或少量视频训练，实现特定动作的迁移与合成。用户可输入文本描述并参考示例视频，生成具有指定动作的新视频，同时保持内容多样性。项目提供训练和推理代码，基于 Stable Video Diffusion 构建，支持自定义数据集。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1063

技术标签

diffusion-models text-to-motion text-to-video text-to-video-generation video-generation

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：高级约 40 分钟部署方式：本地安装 4 步

环境要求

Python 环境（README 要求通过 requirements.txt 安装依赖，未指定具体版本）
已安装 git-lfs（下载模型权重必需，官网 https://git-lfs.com）
能访问 Hugging Face 下载 ruizhaocv/MotionDirector_weights 权重仓库
建议具备可用的 GPU 环境（项目基于 Stable Video Diffusion 训练与推理）

安装与启动步骤

1获取项目源码

从 GitHub 项目地址克隆代码仓库到本地，再进入项目目录进行后续操作。
```
git clone https://github.com/showlab/MotionDirector.git
cd MotionDirector
```
2安装依赖包

在项目根目录下按 README 的 Setup 说明安装 requirements.txt 中的全部 Python 依赖。
```
pip install -r requirements.txt
```
3安装 git-lfs

权重文件通过 Git LFS 托管，必须先初始化 git-lfs，否则克隆下来的是指针文件而非真实权重。
```
git lfs install
```
4下载模型权重

README 要求把权重克隆到项目下的 ./outputs 目录，路径必须一致，否则后续无法正确加载。
```
git clone https://huggingface.co/ruizhaocv/MotionDirector_weights ./outputs
```