Hugging Face LoRA Space 构建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/huggingface-lora-space-builder-zh。
技能介绍
要解决什么问题
训练或托管在 Hugging Face Hub 上的 LoRA,最终往往还需要一个可分享的推理入口:不是本地脚本,而是别人能在浏览器里点开的 Space。难点在于不同 LoRA 的任务与输入形态差异很大——同样是视频到视频,姿态控制与外绘需要的控件、预处理完全不同;若套用通用模板,要么 UI 臃肿、要么推理参数与模型卡片不一致,还会在 ZeroGPU 上踩加载与依赖的坑。
技能如何工作
本技能按固定阶段推进,并强调为当前 LoRA 定制演示,而非拼接模板。
- 收集 LoRA 信息:从 Hub 仓库读取模型卡片与文件(权重、README、示例媒体),推断基础模型、任务类型(
text-to-image/image-to-image/ 视频类等)、触发词与推荐步数、引导尺度、LoRA 缩放等;私有仓库在需要时一次性索取具备写入权限的 HF 令牌。 - 选择管道:对照
references/base-models/中 Qwen-Image、LTX、Krea 2 等参考,并强制以基础模型卡片里的 diffusers 管道类为准,避免「能跑但类错」的静默错误;默认优先 diffusers 的load_lora_weights。 - 设计 UI:结合任务基准与 LoRA 子用例(重打光、外绘、角色动作迁移等)决定控件;必要时用 Hub 自定义组件或
gr.HTML创意模式;示例媒体可来自共享输入池并配合cache_examples=True, cache_mode="lazy"。 - 一次性交付三文件:
app.py(模块级 CUDA 加载、@spaces.GPU推理)、由导入推导的requirements.txt、带 ZeroGPU YAML 的README.md,同一条消息供审阅后再发布。 - 发布与冒烟:默认私有 Space;LoRA 受限时在 Space 密钥中配置
HF_TOKEN;发布后用gradio predict等做端到端验证。
适用边界与注意点
- 一级支持的基础模型系列以技能内参考文件为准;不在列表中的模型需用户确认是否按最接近方案类比或中止。
- 默认硬件为 ZeroGPU(
hardware: zero-a10g);非 PRO/Team/Enterprise 可能回退 CPU 或创建时无法指定 ZeroGPU。 requirements.txt不应重复声明gradio/torch/spaces/huggingface_hub(由运行时或 README 管理);慎用xformers、flash-attn等易冲突依赖。- 避免在
app.py中使用torch.compile;short_description需保持简短以免 YAML 校验失败。
使用场景
- 你在 Hub 上架了图像或视频 LoRA,希望生成可在浏览器试用的 Gradio Space,而不是只给本地推理脚本。
- 你训练的是 LTX 姿态控制或外绘类 LoRA,需要匹配预处理与控件(如姿态预览、宽高比)的专属演示界面。
- LoRA 或基础模型为私有/受限仓库,要在 Space 中正确配置令牌并默认以私有 Space 发布供内部先验。
- 模型卡片写明 Qwen-Image、LTX-2 等基础变体,你需要对照 Hub 卡片选对 diffusers Pipeline 再打包发布。
适合人员
- 在 Hugging Face 发布自训 LoRA 的算法工程师,希望把触发词、推荐步数写进可分享的 ZeroGPU 演示。
- 做扩散/视频 LoRA 微调的研究员,同一任务类别下 UI 差异大,需要按子用例设计 Gradio 而非套模板。
- 维护社区或团队模型仓库的 ML 工程师,要处理多 safetensors 检查点选型并一次性产出 app.py 与 requirements。
- 独立创作者将风格化或编辑类 LoRA 托管在 Hub 上,审阅三文件通过后再把 Space 改为公开。