# H3 Lite

<p align="center"> <img src="assets/h3-lite-hero.gif" alt="H3 Lite — MiniMax H3 本地部署与视频生成 Skill" width="100%"> </p>

<p align="center"> <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-1F5E4A?style=for-the-badge"> <img alt="Hosts Codex" src="https://img.shields.io/badge/Hosts-Codex-4B6B8A?style=for-the-badge"> <img alt="Route Low VRAM Fast" src="https://img.shields.io/badge/Route-Low--VRAM%20Fast-D9A441?style=for-the-badge"> </p>

<p align="center"> 中文 | <a href="README.en.md">English</a> | <a href="#参考资料">参考资料</a> </p>

`H3 Lite` 是一个给 Codex、WorkBuddy 等 AI Agent 使用的 MiniMax H3 本地视频生成 Skill。你只需要用自然语言描述想看的画面，Agent 就会根据电脑配置选择 ComfyUI 路线、准备必要组件、生成带原生声音的视频并检查结果。

它面向第一次接触本地视频生成的用户：你不必先学习 ComfyUI 节点，也不必自己判断模型、文本编码器、LoRA、双 VAE 和低显存参数怎样组合。

## 一分钟交给 Agent

把下面这句话发给 Codex 或 WorkBuddy：

```text 请帮我安装 H3 Lite，并根据我的电脑配置准备本地 MiniMax H3 视频生成环境： https://github.com/Rimagination/h3lite ```

这“一分钟”指把任务和安装位置交给 Agent。模型文件较大，首次下载和部署时间取决于网络、硬盘与电脑配置。

如果不想占用系统盘，把目标位置写进同一条消息：

```text 请把 MiniMax H3 和 ComfyUI 安装到 F:\MiniMax-H3；如果那里已经有健康环境就直接复用。 ```

## 基本配置

当前默认支持 **Windows + NVIDIA CUDA** 的本地低显存路线。已实测验证的下限是 **RTX 3060 Ti 8 GB 显存 + 16 GB 系统内存**；这只代表当前 W4A8 快速路线可以运行，不代表所有 8 GB 显卡都能得到相同结果。仍建议配 32 GB 系统内存和 SSD；12–16 GB 显存会更宽裕。

6 GB 显存属于社区实验路线，建议配 32 GB 系统内存；低于 6 GB 显存或低于 16 GB 系统内存时，不建议下载和部署这套工作流。

AMD/ROCm、RTX 50 系列新架构和原生 BF16 H3 不在当前默认验证范围内，Agent 会先做兼容性判断，不会仅凭显存容量承诺“能跑”。详细硬件、组件和分辨率说明见 [`references/deployment-matrix.md`](references/deployment-matrix.md)。 默认从 `fast` 路线开始。质量档位、I2V/Ref2VA、人脸质量和时间预估由 Agent 根据实际环境自动选择；这些判断不会给视频推理图增加额外采样或模型。

## 常见视频分辨率推荐

社区通常推荐视频模型使用 32 的倍数作为宽高。未指定分辨率时，本 skill 默认使用 `640×352`；指定分辨率时按用户设置执行。

| 用途/比例 | 尺寸 | MP | H3 使用建议 | |---|---:|---:|---| | 横屏 16:9（低显存快速档） | `640×352` | 0.23 | 8 GB 显存首选 | | 横屏 16:9（实验档） | `736×416` | 0.31 | 提升细节和动作遵循度 | | 横屏 16:9（约 0.4MP） | `864×480` | 0.42 | 质量更好但更慢 | | 横屏 16:9（高分辨率） | `1280×704` | 0.90 | 接近 720P，8 GB 显存不建议直接生成 | | 竖屏 9:16（低显存） | `352×640` | 0.23 | 适合短视频竖屏草稿 | | 竖屏 9:16（中等质量） | `416×73