项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1119
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3 环境(具备 python3 与 pip)
- 建议使用 Linux/macOS 终端(README 中激活命令为 source venv/bin/activate)
- 已安装 git-lfs,用于拉取 Hugging Face 上的模型权重
- 磁盘空间需足够存放 Hotshot-XL 与 SDXL-512 两套模型权重
- 可访问 Hugging Face 与 GitHub 的网络环境
安装与启动步骤
-
1获取项目代码
把项目源码克隆到本地,后续所有命令都在项目根目录下执行。
git clone https://github.com/hotshotco/Hotshot-XL cd Hotshot-XL -
2升级并安装虚拟环境
先升级 pip 的 virtualenv 包,README 的 Environment Setup 第一步。
pip install virtualenv --upgrade -
3创建虚拟环境
用当前 python3 创建一个名为 venv 的隔离环境,避免污染系统包。
virtualenv -p $(which python3) venv -
4激活虚拟环境
激活后终端提示符前会出现 (venv),后续安装都装进该环境。
source venv/bin/activate -
5安装项目依赖
按 requirements.txt 安装 Hotshot-XL 所需的 Python 依赖,耗时较长。
pip install -r requirements.txt -
6安装 git-lfs
模型权重是 LFS 大文件,必须先执行该命令,否则拉取到的是指针文件。
git lfs install -
7下载 Hotshot-XL 权重
从 Hugging Face 克隆 Hotshot-XL 模型仓库,体积较大需耐心等待。
git clone https://huggingface.co/hotshotco/Hotshot-XL -
8下载 SDXL-512 基础模型
Hotshot-XL 需搭配 SDXL 模型使用,README 推荐再拉取 SDXL-512。
git clone https://huggingface.co/hotshotco/SDXL-512
如何确认成功
README 未提供启动脚本;完成依赖安装且两个模型仓库成功拉取到本地(非 LFS 指针文件)即视为环境就绪。
常见问题
Q:为什么下载的模型文件很小?
A:因为没有装 git-lfs。需先安装 git-lfs 并执行 git lfs install,再重新克隆 Hugging Face 模型仓库,否则拿到的是 LFS 指针文件。
Q:一定要用 README 里的 SDXL-512 吗?
A:不是。Hotshot-XL 可与任意微调过的 SDXL 模型配合生成 GIF,README 只是推荐搭配 512x512 微调的 SDXL 模型效果更好。
Q:能生成我自己的形象或风格吗?
A:可以。直接加载你自己基于 SDXL 的 LORA 即可生成个性化主体的 GIF,无需微调 Hotshot-XL 本身。
Q:生成的 GIF 有多长?
A:Hotshot-XL 的训练设定是 1 秒、8 FPS 的 GIF,并支持多种宽高比。
Q:能控制画面构图吗?
A:可以。Hotshot-XL 兼容 SDXL ControlNet,可用它来控制生成 GIF 的构图与布局。
注意事项
- 模型权重通过 git-lfs 从 Hugging Face 拉取,克隆前务必先完成 git lfs install。
- README 只给出环境搭建与权重下载说明,未提供推理/启动命令,实际生成需参考官方模型卡或仓库示例脚本。
- 激活虚拟环境的命令为 Linux/macOS 写法,Windows 下需使用 venv 对应的激活脚本。
- 两套模型权重体积较大,请预留充足磁盘空间与下载时间。
核心亮点
- 基于SDXL,生成质量高,动画连贯性好
- 支持自定义动画长度和风格,灵活性强
- 与SDXL生态兼容,可复用现有模型和工具
不足之处
- 文档/社区待观察
- 生成GIF分辨率可能受限于模型,高分辨率场景需额外处理
适用场景
- 社交媒体表情包和创意动图制作
- 快速生成短视频素材或广告动图
- 游戏和UI设计中的动态元素原型
替代项目
AnimateDiff、ModelScope Text-to-Video、CogVideo
上一篇:Flux-3-Dev-API
下一篇:DirectorsConsole
同类项目推荐
aperture
开源
一眼看透 Stable Diffusion 在关注什么,调试生成更轻松。
Visualize attention layers from Stable Diffusion
tryemoji
开源
输入 emoji,几秒生成 AI 艺术画作
Turn emoji into amazing artwork via AI
Awesome-Style-Transfer-with-Diff···
开源
一站式掌握扩散模型风格迁移前沿方法
A curated list of recent style transfer methods with diffusion models
BlendGAN
开源
一个模型搞定任意人脸风格,无需重新训练
Official PyTorch implementation of "BlendGAN: Implicitly GAN Blending for Arbitrary ···
stable-diffusion-API
开源
快速搭建 Stable Diffusion 图像生成 API 服务
Unofficial Fastapi implementation of Stable-Diffusion API
imglib2
开源
多维科学图像的 Java 底层引擎,算法一次写好多维通用
A generic next-generation Java library for image processing
awesome-ai-image-models
开源
一张清单,快速对比主流AI图像模型的价格与API。
The most complete, up-to-date comparison of AI image generation models — which mode···
textboost
开源
一张图微调文本编码器,让 Stable Diffusion 学会你的专属主体
[TMLR'26] Towards One-Shot Personalization of Text-to-Image Models via Fine-tuning T···
HiDream_O1-ComfyUI
开源
在 ComfyUI 中直接使用 HiDream O1 生成图像并训练 LoRA
HiDream O1 Image nodes + LoRA training for ComfyUI
