Mochi 项目使用与启动教程

Mochi 项目使用与启动教程

mochi The best OSS video generation models 项目地址: https://gitcode.com/gh_mirrors/mochi9/mochi

1. 项目的目录结构及介绍

Mochi 项目是一个开源的视频生成模型，其目录结构如下：

mochi/
├── assets/                 # 存放项目相关资源文件
├── contrib/                # 贡献者目录，可能包含额外的贡献代码或资源
├── demos/                  # 包含演示脚本，如启动 UI 界面和命令行工具
├── scripts/                # 包含项目运行所需的各种脚本
├── src/                    # 源代码目录，包含模型定义和核心功能
│   └── genmo/              # 包含模型实现相关的 Python 模块
├── .gitignore              # 指定 Git 忽略的文件和目录
├── .python-version         # 指定项目所需的 Python 版本
├── LICENSE                 # 项目许可证文件，Apache-2.0 许可
├── README.md               # 项目说明文件
├── pyproject.toml          # 项目配置文件，定义了项目依赖等
├── pyrightconfig.json      # Pyright 配置文件，用于代码静态分析
├── requirements.txt        # 项目依赖文件，用于安装 Python 包
└── uv.lock                 # UV 包的锁定文件

2. 项目的启动文件介绍

项目的启动文件主要位于 demos/ 目录中，以下是一些主要的启动文件及其用途：

• gradio_ui.py: 启动 Gradio 用户界面，用于交互式地生成视频。
• cli.py: 命令行工具，用于从命令行生成视频。

例如，要启动 Gradio UI 界面，可以在终端中运行以下命令：

python3 ./demos/gradio_ui.py --model_dir weights/ --cpu_offload

3. 项目的配置文件介绍

项目的配置文件主要包括以下几个：

• .python-version: 指定了项目所需的 Python 版本。
• pyproject.toml: 包含了项目的元数据和依赖信息。以下是一个示例：

[project]
name = "mochi"
version = "0.1.0"
description = "A state of the art video generation model by Genmo."
authors = ["Genmo Team"]
license = { file = "LICENSE" }
requires-python = ">=3.8"

[project.urls]
"Documentation" = "https://github.com/genmoai/models"
"Bug Tracker" = "https://github.com/genmoai/models/issues"

[tool.poetry.dependencies]
python = "^3.8"
uv = "^0.17.0"
torch = "^1.12.0"
torchvision = "^0.13.0"
tqdm = "^4.64.0"
transformers = "^4.19.2"

• requirements.txt: 列出了项目的 Python 依赖。以下是一个示例：

uv==0.17.0
torch==1.12.0
torchvision==0.13.0
tqdm==4.64.0
transformers==4.19.2

确保在运行项目之前安装了所有列出的依赖项。

mochi The best OSS video generation models 项目地址: https://gitcode.com/gh_mirrors/mochi9/mochi