add-diffusion-model

Add diffusion models to vLLM-Omni with Cache-DiT acceleration and multi-GPU parallelism.

6.0k|1.4k|Updated Sep 11, 2025
One-click install
npx skills add https://github.com/vllm-project/vllm-omni --skill add-diffusion-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-diffusion-model
Source: https://github.com/vllm-project/vllm-omni/tree/main/.claude/skills/add-diffusion-model
Command: npx skills add https://github.com/vllm-project/vllm-omni --skill add-diffusion-model

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reduces the complexity of adding a new diffusion model to vLLM-Omni by providing a repeatable workflow that handles compatibility, acceleration, and multi-GPU deployment.

Core Features & Use Cases

  • Supports both Diffusers-based pipelines and custom repositories.
  • Guides porting to vLLM-Omni transformers and integrating Cache-DiT acceleration.
  • Covers registration, testing, documentation, and offline download script scaffolding.
  • Enables multi-GPU parallelism patterns (TP, SP/USP, CFG, HSDP) and production-ready workflows.

Quick Start

Create or adapt a diffusion model, register it in the diffusion registry, and run an offline test script to verify basic functionality.

Frequently Asked Questions about add-diffusion-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new diffusion model to vLLM-Omni for multi-GPU parallelism?

To add a diffusion model, you port the transformer, register it in the diffusion registry, and configure multi-GPU parallelism patterns like tensor and sequence parallelism. This workflow ensures correct model_index.json setup and Python package exports.

Does vLLM-Omni support integrating custom diffusion repositories and Diffusers pipelines?

Yes, vLLM-Omni supports integrating both Diffusers-based pipelines and custom repositories. The integration process involves porting transformers, registering the model, and testing to ensure compatibility across different pipeline architectures.

How does Cache-DiT acceleration work when integrating diffusion models?

Cache-DiT acceleration optimizes diffusion model inference within vLLM-Omni by caching intermediate computations. You integrate it during the transformer porting phase to speed up generation without altering the core model architecture.

What multi-GPU parallelism patterns are available for diffusion models in vLLM-Omni?

vLLM-Omni supports tensor parallelism (TP), sequence parallelism (SP/USP), classifier-free guidance (CFG), and hybrid sharded data parallelism (HSDP). These patterns enable scalable, production-ready multi-GPU deployment for diffusion models.

What steps are needed to register a diffusion model and test it in vLLM-Omni?

You must register the model in the diffusion registry, ensure proper Python package exports, and run an offline test script. Scaffolding offline download scripts and updating production documentation are also required for complete integration.

When should I use sequence parallelism over tensor parallelism for diffusion models?

Use sequence parallelism (SP/USP) when scaling diffusion models across multiple GPUs to handle long sequences efficiently, whereas tensor parallelism (TP) partitions model weights. vLLM-Omni supports both, often combining them with CFG and HSDP.