[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6GJNQHSDZKBPNB35YPBFMM2":3,"skill-same:01M6GJNQHSDZKBPNB35YPBFMM2":96},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":64,"commitSha":65,"skillDirectory":66,"forksCount":67,"repositoryHtmlUrl":68,"repositoryHomepageUrl":6,"ownerHtmlUrl":69,"ownerBlogUrl":6,"ownerDescription":70,"updatedAt":71,"install":72,"resources":85},"01M6GJNQHSDZKBPNB35YPBFMM2","stable-diffusion-image-generation",null,"State-of-the-art text-to-image generation with Stable Diffusion models via HuggingFace Diffusers. Use when generating images from text prompts, performing image-to-image translation, inpainting, or building custom diffusion pipelines.","zapabob\u002FSkills","zapabob","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F130830376?v=4","01M6DBMYZAGRTFQDSQYW3W764P","峯岸 亮","01M6DBMZ3GKDSJ01NZ9XTZD7JD",2,"MIT","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fstable-diffusion\u002Fvariants\u002Fhermes-agent-optional\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"diffusion","generation","Image Generation","Stable Diffusion","stable diffusion image generation","image","use","with","Accelerate","translation","Art","images","vision","computer","text","Transformers","multimodal","windows","linux","macos","2026-11-10 10:12:30",false,"---\nname: stable-diffusion-image-generation\ndescription: State-of-the-art text-to-image generation with Stable Diffusion models via HuggingFace Diffusers. Use when generating images from text prompts, performing image-to-image translation, inpainting, or building custom diffusion pipelines.\nversion: 1.0.0\nauthor: Orchestra Research\nlicense: MIT\ndependencies: [diffusers>=0.30.0, transformers>=4.41.0, accelerate>=0.31.0, torch>=2.0.0]\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [Image Generation, Stable Diffusion, Diffusers, Text-to-Image, Multimodal, Computer Vision]\n\n---\n\n# Stable Diffusion Image Generation\n\nComprehensive guide to generating images with Stable Diffusion using the HuggingFace Diffusers library.\n\n## When to use Stable Diffusion\n\n**Use Stable Diffusion when:**\n- Generating images from text descriptions\n- Performing image-to-image translation (style transfer, enhancement)\n- Inpainting (filling in masked regions)\n- Outpainting (extending images beyond boundaries)\n- Creating variations of existing images\n- Building custom image generation workflows\n\n**Key features:**\n- **Text-to-Image**: Generate images from natural language prompts\n- **Image-to-Image**: Transform existing images with text guidance\n- **Inpainting**: Fill masked regions with context-aware content\n- **ControlNet**: Add spatial conditioning (edges, poses, depth)\n- **LoRA Support**: Efficient fine-tuning and style adaptation\n- **Multiple Models**: SD 1.5, SDXL, SD 3.0, Flux support\n\n**Use alternatives instead:**\n- **DALL-E 3**: For API-based generation without GPU\n- **Midjourney**: For artistic, stylized outputs\n- **Imagen**: For Google Cloud integration\n- **Leonardo.ai**: For web-based creative workflows\n\n## Quick start\n\n### Installation\n\n```bash\npip install diffusers transformers accelerate torch\npip install xformers  # Optional: memory-efficient attention\n```\n\n### Basic text-to-image\n\n```python\nfrom diffusers import DiffusionPipeline\nimport torch\n\n# Load pipeline (auto-detects model type)\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n)\npipe.to(\"cuda\")\n\n# Generate image\nimage = pipe(\n    \"A serene mountain landscape at sunset, highly detailed\",\n    num_inference_steps=50,\n    guidance_scale=7.5\n).images[0]\n\nimage.save(\"output.png\")\n```\n\n### Using SDXL (higher quality)\n\n```python\nfrom diffusers import AutoPipelineForText2Image\nimport torch\n\npipe = AutoPipelineForText2Image.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\npipe.to(\"cuda\")\n\n# Enable memory optimization\npipe.enable_model_cpu_offload()\n\nimage = pipe(\n    prompt=\"A futuristic city with flying cars, cinematic lighting\",\n    height=1024,\n    width=1024,\n    num_inference_steps=30\n).images[0]\n```\n\n## Architecture overview\n\n### Three-pillar design\n\nDiffusers is built around three core components:\n\n```\nPipeline (orchestration)\n├── Model (neural networks)\n│   ├── UNet \u002F Transformer (noise prediction)\n│   ├── VAE (latent encoding\u002Fdecoding)\n│   └── Text Encoder (CLIP\u002FT5)\n└── Scheduler (denoising algorithm)\n```\n\n### Pipeline inference flow\n\n```\nText Prompt → Text Encoder → Text Embeddings\n                                    ↓\nRandom Noise → [Denoising Loop] ← Scheduler\n                      ↓\n               Predicted Noise\n                      ↓\n              VAE Decoder → Final Image\n```\n\n## Core concepts\n\n### Pipelines\n\nPipelines orchestrate complete workflows:\n\n| Pipeline | Purpose |\n|----------|---------|\n| `StableDiffusionPipeline` | Text-to-image (SD 1.x\u002F2.x) |\n| `StableDiffusionXLPipeline` | Text-to-image (SDXL) |\n| `StableDiffusion3Pipeline` | Text-to-image (SD 3.0) |\n| `FluxPipeline` | Text-to-image (Flux models) |\n| `StableDiffusionImg2ImgPipeline` | Image-to-image |\n| `StableDiffusionInpaintPipeline` | Inpainting |\n\n### Schedulers\n\nSchedulers control the denoising process:\n\n| Scheduler | Steps | Quality | Use Case |\n|-----------|-------|---------|----------|\n| `EulerDiscreteScheduler` | 20-50 | Good | Default choice |\n| `EulerAncestralDiscreteScheduler` | 20-50 | Good | More variation |\n| `DPMSolverMultistepScheduler` | 15-25 | Excellent | Fast, high quality |\n| `DDIMScheduler` | 50-100 | Good | Deterministic |\n| `LCMScheduler` | 4-8 | Good | Very fast |\n| `UniPCMultistepScheduler` | 15-25 | Excellent | Fast convergence |\n\n### Swapping schedulers\n\n```python\nfrom diffusers import DPMSolverMultistepScheduler\n\n# Swap for faster generation\npipe.scheduler = DPMSolverMultistepScheduler.from_config(\n    pipe.scheduler.config\n)\n\n# Now generate with fewer steps\nimage = pipe(prompt, num_inference_steps=20).images[0]\n```\n\n## Generation parameters\n\n### Key parameters\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| `prompt` | Required | Text description of desired image |\n| `negative_prompt` | None | What to avoid in the image |\n| `num_inference_steps` | 50 | Denoising steps (more = better quality) |\n| `guidance_scale` | 7.5 | Prompt adherence (7-12 typical) |\n| `height`, `width` | 512\u002F1024 | Output dimensions (multiples of 8) |\n| `generator` | None | Torch generator for reproducibility |\n| `num_images_per_prompt` | 1 | Batch size |\n\n### Reproducible generation\n\n```python\nimport torch\n\ngenerator = torch.Generator(device=\"cuda\").manual_seed(42)\n\nimage = pipe(\n    prompt=\"A cat wearing a top hat\",\n    generator=generator,\n    num_inference_steps=50\n).images[0]\n```\n\n### Negative prompts\n\n```python\nimage = pipe(\n    prompt=\"Professional photo of a dog in a garden\",\n    negative_prompt=\"blurry, low quality, distorted, ugly, bad anatomy\",\n    guidance_scale=7.5\n).images[0]\n```\n\n## Image-to-image\n\nTransform existing images with text guidance:\n\n```python\nfrom diffusers import AutoPipelineForImage2Image\nfrom PIL import Image\n\npipe = AutoPipelineForImage2Image.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\ninit_image = Image.open(\"input.jpg\").resize((512, 512))\n\nimage = pipe(\n    prompt=\"A watercolor painting of the scene\",\n    image=init_image,\n    strength=0.75,  # How much to transform (0-1)\n    num_inference_steps=50\n).images[0]\n```\n\n## Inpainting\n\nFill masked regions:\n\n```python\nfrom diffusers import AutoPipelineForInpainting\nfrom PIL import Image\n\npipe = AutoPipelineForInpainting.from_pretrained(\n    \"runwayml\u002Fstable-diffusion-inpainting\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\nimage = Image.open(\"photo.jpg\")\nmask = Image.open(\"mask.png\")  # White = inpaint region\n\nresult = pipe(\n    prompt=\"A red car parked on the street\",\n    image=image,\n    mask_image=mask,\n    num_inference_steps=50\n).images[0]\n```\n\n## ControlNet\n\nAdd spatial conditioning for precise control:\n\n```python\nfrom diffusers import StableDiffusionControlNetPipeline, ControlNetModel\nimport torch\n\n# Load ControlNet for edge conditioning\ncontrolnet = ControlNetModel.from_pretrained(\n    \"lllyasviel\u002Fcontrol_v11p_sd15_canny\",\n    torch_dtype=torch.float16\n)\n\npipe = StableDiffusionControlNetPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    controlnet=controlnet,\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Use Canny edge image as control\ncontrol_image = get_canny_image(input_image)\n\nimage = pipe(\n    prompt=\"A beautiful house in the style of Van Gogh\",\n    image=control_image,\n    num_inference_steps=30\n).images[0]\n```\n\n### Available ControlNets\n\n| ControlNet | Input Type | Use Case |\n|------------|------------|----------|\n| `canny` | Edge maps | Preserve structure |\n| `openpose` | Pose skeletons | Human poses |\n| `depth` | Depth maps | 3D-aware generation |\n| `normal` | Normal maps | Surface details |\n| `mlsd` | Line segments | Architectural lines |\n| `scribble` | Rough sketches | Sketch-to-image |\n\n## LoRA adapters\n\nLoad fine-tuned style adapters:\n\n```python\nfrom diffusers import DiffusionPipeline\n\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Load LoRA weights\npipe.load_lora_weights(\"path\u002Fto\u002Flora\", weight_name=\"style.safetensors\")\n\n# Generate with LoRA style\nimage = pipe(\"A portrait in the trained style\").images[0]\n\n# Adjust LoRA strength\npipe.fuse_lora(lora_scale=0.8)\n\n# Unload LoRA\npipe.unload_lora_weights()\n```\n\n### Multiple LoRAs\n\n```python\n# Load multiple LoRAs\npipe.load_lora_weights(\"lora1\", adapter_name=\"style\")\npipe.load_lora_weights(\"lora2\", adapter_name=\"character\")\n\n# Set weights for each\npipe.set_adapters([\"style\", \"character\"], adapter_weights=[0.7, 0.5])\n\nimage = pipe(\"A portrait\").images[0]\n```\n\n## Memory optimization\n\n### Enable CPU offloading\n\n```python\n# Model CPU offload - moves models to CPU when not in use\npipe.enable_model_cpu_offload()\n\n# Sequential CPU offload - more aggressive, slower\npipe.enable_sequential_cpu_offload()\n```\n\n### Attention slicing\n\n```python\n# Reduce memory by computing attention in chunks\npipe.enable_attention_slicing()\n\n# Or specific chunk size\npipe.enable_attention_slicing(\"max\")\n```\n\n### xFormers memory-efficient attention\n\n```python\n# Requires xformers package\npipe.enable_xformers_memory_efficient_attention()\n```\n\n### VAE slicing for large images\n\n```python\n# Decode latents in tiles for large images\npipe.enable_vae_slicing()\npipe.enable_vae_tiling()\n```\n\n## Model variants\n\n### Loading different precisions\n\n```python\n# FP16 (recommended for GPU)\npipe = DiffusionPipeline.from_pretrained(\n    \"model-id\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\n\n# BF16 (better precision, requires Ampere+ GPU)\npipe = DiffusionPipeline.from_pretrained(\n    \"model-id\",\n    torch_dtype=torch.bfloat16\n)\n```\n\n### Loading specific components\n\n```python\nfrom diffusers import UNet2DConditionModel, AutoencoderKL\n\n# Load custom VAE\nvae = AutoencoderKL.from_pretrained(\"stabilityai\u002Fsd-vae-ft-mse\")\n\n# Use with pipeline\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    vae=vae,\n    torch_dtype=torch.float16\n)\n```\n\n## Batch generation\n\nGenerate multiple images efficiently:\n\n```python\n# Multiple prompts\nprompts = [\n    \"A cat playing piano\",\n    \"A dog reading a book\",\n    \"A bird painting a picture\"\n]\n\nimages = pipe(prompts, num_inference_steps=30).images\n\n# Multiple images per prompt\nimages = pipe(\n    \"A beautiful sunset\",\n    num_images_per_prompt=4,\n    num_inference_steps=30\n).images\n```\n\n## Common workflows\n\n### Workflow 1: High-quality generation\n\n```python\nfrom diffusers import StableDiffusionXLPipeline, DPMSolverMultistepScheduler\nimport torch\n\n# 1. Load SDXL with optimizations\npipe = StableDiffusionXLPipeline.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\npipe.to(\"cuda\")\npipe.scheduler = DPMSolverMultistepScheduler.from_config(pipe.scheduler.config)\npipe.enable_model_cpu_offload()\n\n# 2. Generate with quality settings\nimage = pipe(\n    prompt=\"A majestic lion in the savanna, golden hour lighting, 8k, detailed fur\",\n    negative_prompt=\"blurry, low quality, cartoon, anime, sketch\",\n    num_inference_steps=30,\n    guidance_scale=7.5,\n    height=1024,\n    width=1024\n).images[0]\n```\n\n### Workflow 2: Fast prototyping\n\n```python\nfrom diffusers import AutoPipelineForText2Image, LCMScheduler\nimport torch\n\n# Use LCM for 4-8 step generation\npipe = AutoPipelineForText2Image.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Load LCM LoRA for fast generation\npipe.load_lora_weights(\"latent-consistency\u002Flcm-lora-sdxl\")\npipe.scheduler = LCMScheduler.from_config(pipe.scheduler.config)\npipe.fuse_lora()\n\n# Generate in ~1 second\nimage = pipe(\n    \"A beautiful landscape\",\n    num_inference_steps=4,\n    guidance_scale=1.0\n).images[0]\n```\n\n## Common issues\n\n**CUDA out of memory:**\n```python\n# Enable memory optimizations\npipe.enable_model_cpu_offload()\npipe.enable_attention_slicing()\npipe.enable_vae_slicing()\n\n# Or use lower precision\npipe = DiffusionPipeline.from_pretrained(model_id, torch_dtype=torch.float16)\n```\n\n**Black\u002Fnoise images:**\n```python\n# Check VAE configuration\n# Use safety checker bypass if needed\npipe.safety_checker = None\n\n# Ensure proper dtype consistency\npipe = pipe.to(dtype=torch.float16)\n```\n\n**Slow generation:**\n```python\n# Use faster scheduler\nfrom diffusers import DPMSolverMultistepScheduler\npipe.scheduler = DPMSolverMultistepScheduler.from_config(pipe.scheduler.config)\n\n# Reduce steps\nimage = pipe(prompt, num_inference_steps=20).images[0]\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom pipelines, fine-tuning, deployment\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues and solutions\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Fdiffusers\n- **Repository**: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Fdiffusers\n- **Model Hub**: https:\u002F\u002Fhuggingface.co\u002Fmodels?library=diffusers\n- **Discord**: https:\u002F\u002Fdiscord.gg\u002Fdiffusers\n","# Stable Diffusion Image Generation\n\nComprehensive guide to generating images with Stable Diffusion using the HuggingFace Diffusers library.\n\n## When to use Stable Diffusion\n\n**Use Stable Diffusion when:**\n- Generating images from text descriptions\n- Performing image-to-image translation (style transfer, enhancement)\n- Inpainting (filling in masked regions)\n- Outpainting (extending images beyond boundaries)\n- Creating variations of existing images\n- Building custom image generation workflows\n\n**Key features:**\n- **Text-to-Image**: Generate images from natural language prompts\n- **Image-to-Image**: Transform existing images with text guidance\n- **Inpainting**: Fill masked regions with context-aware content\n- **ControlNet**: Add spatial conditioning (edges, poses, depth)\n- **LoRA Support**: Efficient fine-tuning and style adaptation\n- **Multiple Models**: SD 1.5, SDXL, SD 3.0, Flux support\n\n**Use alternatives instead:**\n- **DALL-E 3**: For API-based generation without GPU\n- **Midjourney**: For artistic, stylized outputs\n- **Imagen**: For Google Cloud integration\n- **Leonardo.ai**: For web-based creative workflows\n\n## Quick start\n\n### Installation\n\n```bash\npip install diffusers transformers accelerate torch\npip install xformers  # Optional: memory-efficient attention\n```\n\n### Basic text-to-image\n\n```python\nfrom diffusers import DiffusionPipeline\nimport torch\n\n# Load pipeline (auto-detects model type)\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n)\npipe.to(\"cuda\")\n\n# Generate image\nimage = pipe(\n    \"A serene mountain landscape at sunset, highly detailed\",\n    num_inference_steps=50,\n    guidance_scale=7.5\n).images[0]\n\nimage.save(\"output.png\")\n```\n\n### Using SDXL (higher quality)\n\n```python\nfrom diffusers import AutoPipelineForText2Image\nimport torch\n\npipe = AutoPipelineForText2Image.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\npipe.to(\"cuda\")\n\n# Enable memory optimization\npipe.enable_model_cpu_offload()\n\nimage = pipe(\n    prompt=\"A futuristic city with flying cars, cinematic lighting\",\n    height=1024,\n    width=1024,\n    num_inference_steps=30\n).images[0]\n```\n\n## Architecture overview\n\n### Three-pillar design\n\nDiffusers is built around three core components:\n\n```\nPipeline (orchestration)\n├── Model (neural networks)\n│   ├── UNet \u002F Transformer (noise prediction)\n│   ├── VAE (latent encoding\u002Fdecoding)\n│   └── Text Encoder (CLIP\u002FT5)\n└── Scheduler (denoising algorithm)\n```\n\n### Pipeline inference flow\n\n```\nText Prompt → Text Encoder → Text Embeddings\n                                    ↓\nRandom Noise → [Denoising Loop] ← Scheduler\n                      ↓\n               Predicted Noise\n                      ↓\n              VAE Decoder → Final Image\n```\n\n## Core concepts\n\n### Pipelines\n\nPipelines orchestrate complete workflows:\n\n| Pipeline | Purpose |\n|----------|---------|\n| `StableDiffusionPipeline` | Text-to-image (SD 1.x\u002F2.x) |\n| `StableDiffusionXLPipeline` | Text-to-image (SDXL) |\n| `StableDiffusion3Pipeline` | Text-to-image (SD 3.0) |\n| `FluxPipeline` | Text-to-image (Flux models) |\n| `StableDiffusionImg2ImgPipeline` | Image-to-image |\n| `StableDiffusionInpaintPipeline` | Inpainting |\n\n### Schedulers\n\nSchedulers control the denoising process:\n\n| Scheduler | Steps | Quality | Use Case |\n|-----------|-------|---------|----------|\n| `EulerDiscreteScheduler` | 20-50 | Good | Default choice |\n| `EulerAncestralDiscreteScheduler` | 20-50 | Good | More variation |\n| `DPMSolverMultistepScheduler` | 15-25 | Excellent | Fast, high quality |\n| `DDIMScheduler` | 50-100 | Good | Deterministic |\n| `LCMScheduler` | 4-8 | Good | Very fast |\n| `UniPCMultistepScheduler` | 15-25 | Excellent | Fast convergence |\n\n### Swapping schedulers\n\n```python\nfrom diffusers import DPMSolverMultistepScheduler\n\n# Swap for faster generation\npipe.scheduler = DPMSolverMultistepScheduler.from_config(\n    pipe.scheduler.config\n)\n\n# Now generate with fewer steps\nimage = pipe(prompt, num_inference_steps=20).images[0]\n```\n\n## Generation parameters\n\n### Key parameters\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| `prompt` | Required | Text description of desired image |\n| `negative_prompt` | None | What to avoid in the image |\n| `num_inference_steps` | 50 | Denoising steps (more = better quality) |\n| `guidance_scale` | 7.5 | Prompt adherence (7-12 typical) |\n| `height`, `width` | 512\u002F1024 | Output dimensions (multiples of 8) |\n| `generator` | None | Torch generator for reproducibility |\n| `num_images_per_prompt` | 1 | Batch size |\n\n### Reproducible generation\n\n```python\nimport torch\n\ngenerator = torch.Generator(device=\"cuda\").manual_seed(42)\n\nimage = pipe(\n    prompt=\"A cat wearing a top hat\",\n    generator=generator,\n    num_inference_steps=50\n).images[0]\n```\n\n### Negative prompts\n\n```python\nimage = pipe(\n    prompt=\"Professional photo of a dog in a garden\",\n    negative_prompt=\"blurry, low quality, distorted, ugly, bad anatomy\",\n    guidance_scale=7.5\n).images[0]\n```\n\n## Image-to-image\n\nTransform existing images with text guidance:\n\n```python\nfrom diffusers import AutoPipelineForImage2Image\nfrom PIL import Image\n\npipe = AutoPipelineForImage2Image.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\ninit_image = Image.open(\"input.jpg\").resize((512, 512))\n\nimage = pipe(\n    prompt=\"A watercolor painting of the scene\",\n    image=init_image,\n    strength=0.75,  # How much to transform (0-1)\n    num_inference_steps=50\n).images[0]\n```\n\n## Inpainting\n\nFill masked regions:\n\n```python\nfrom diffusers import AutoPipelineForInpainting\nfrom PIL import Image\n\npipe = AutoPipelineForInpainting.from_pretrained(\n    \"runwayml\u002Fstable-diffusion-inpainting\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\nimage = Image.open(\"photo.jpg\")\nmask = Image.open(\"mask.png\")  # White = inpaint region\n\nresult = pipe(\n    prompt=\"A red car parked on the street\",\n    image=image,\n    mask_image=mask,\n    num_inference_steps=50\n).images[0]\n```\n\n## ControlNet\n\nAdd spatial conditioning for precise control:\n\n```python\nfrom diffusers import StableDiffusionControlNetPipeline, ControlNetModel\nimport torch\n\n# Load ControlNet for edge conditioning\ncontrolnet = ControlNetModel.from_pretrained(\n    \"lllyasviel\u002Fcontrol_v11p_sd15_canny\",\n    torch_dtype=torch.float16\n)\n\npipe = StableDiffusionControlNetPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    controlnet=controlnet,\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Use Canny edge image as control\ncontrol_image = get_canny_image(input_image)\n\nimage = pipe(\n    prompt=\"A beautiful house in the style of Van Gogh\",\n    image=control_image,\n    num_inference_steps=30\n).images[0]\n```\n\n### Available ControlNets\n\n| ControlNet | Input Type | Use Case |\n|------------|------------|----------|\n| `canny` | Edge maps | Preserve structure |\n| `openpose` | Pose skeletons | Human poses |\n| `depth` | Depth maps | 3D-aware generation |\n| `normal` | Normal maps | Surface details |\n| `mlsd` | Line segments | Architectural lines |\n| `scribble` | Rough sketches | Sketch-to-image |\n\n## LoRA adapters\n\nLoad fine-tuned style adapters:\n\n```python\nfrom diffusers import DiffusionPipeline\n\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Load LoRA weights\npipe.load_lora_weights(\"path\u002Fto\u002Flora\", weight_name=\"style.safetensors\")\n\n# Generate with LoRA style\nimage = pipe(\"A portrait in the trained style\").images[0]\n\n# Adjust LoRA strength\npipe.fuse_lora(lora_scale=0.8)\n\n# Unload LoRA\npipe.unload_lora_weights()\n```\n\n### Multiple LoRAs\n\n```python\n# Load multiple LoRAs\npipe.load_lora_weights(\"lora1\", adapter_name=\"style\")\npipe.load_lora_weights(\"lora2\", adapter_name=\"character\")\n\n# Set weights for each\npipe.set_adapters([\"style\", \"character\"], adapter_weights=[0.7, 0.5])\n\nimage = pipe(\"A portrait\").images[0]\n```\n\n## Memory optimization\n\n### Enable CPU offloading\n\n```python\n# Model CPU offload - moves models to CPU when not in use\npipe.enable_model_cpu_offload()\n\n# Sequential CPU offload - more aggressive, slower\npipe.enable_sequential_cpu_offload()\n```\n\n### Attention slicing\n\n```python\n# Reduce memory by computing attention in chunks\npipe.enable_attention_slicing()\n\n# Or specific chunk size\npipe.enable_attention_slicing(\"max\")\n```\n\n### xFormers memory-efficient attention\n\n```python\n# Requires xformers package\npipe.enable_xformers_memory_efficient_attention()\n```\n\n### VAE slicing for large images\n\n```python\n# Decode latents in tiles for large images\npipe.enable_vae_slicing()\npipe.enable_vae_tiling()\n```\n\n## Model variants\n\n### Loading different precisions\n\n```python\n# FP16 (recommended for GPU)\npipe = DiffusionPipeline.from_pretrained(\n    \"model-id\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\n\n# BF16 (better precision, requires Ampere+ GPU)\npipe = DiffusionPipeline.from_pretrained(\n    \"model-id\",\n    torch_dtype=torch.bfloat16\n)\n```\n\n### Loading specific components\n\n```python\nfrom diffusers import UNet2DConditionModel, AutoencoderKL\n\n# Load custom VAE\nvae = AutoencoderKL.from_pretrained(\"stabilityai\u002Fsd-vae-ft-mse\")\n\n# Use with pipeline\npipe = DiffusionPipeline.from_pretrained(\n    \"stable-diffusion-v1-5\u002Fstable-diffusion-v1-5\",\n    vae=vae,\n    torch_dtype=torch.float16\n)\n```\n\n## Batch generation\n\nGenerate multiple images efficiently:\n\n```python\n# Multiple prompts\nprompts = [\n    \"A cat playing piano\",\n    \"A dog reading a book\",\n    \"A bird painting a picture\"\n]\n\nimages = pipe(prompts, num_inference_steps=30).images\n\n# Multiple images per prompt\nimages = pipe(\n    \"A beautiful sunset\",\n    num_images_per_prompt=4,\n    num_inference_steps=30\n).images\n```\n\n## Common workflows\n\n### Workflow 1: High-quality generation\n\n```python\nfrom diffusers import StableDiffusionXLPipeline, DPMSolverMultistepScheduler\nimport torch\n\n# 1. Load SDXL with optimizations\npipe = StableDiffusionXLPipeline.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16,\n    variant=\"fp16\"\n)\npipe.to(\"cuda\")\npipe.scheduler = DPMSolverMultistepScheduler.from_config(pipe.scheduler.config)\npipe.enable_model_cpu_offload()\n\n# 2. Generate with quality settings\nimage = pipe(\n    prompt=\"A majestic lion in the savanna, golden hour lighting, 8k, detailed fur\",\n    negative_prompt=\"blurry, low quality, cartoon, anime, sketch\",\n    num_inference_steps=30,\n    guidance_scale=7.5,\n    height=1024,\n    width=1024\n).images[0]\n```\n\n### Workflow 2: Fast prototyping\n\n```python\nfrom diffusers import AutoPipelineForText2Image, LCMScheduler\nimport torch\n\n# Use LCM for 4-8 step generation\npipe = AutoPipelineForText2Image.from_pretrained(\n    \"stabilityai\u002Fstable-diffusion-xl-base-1.0\",\n    torch_dtype=torch.float16\n).to(\"cuda\")\n\n# Load LCM LoRA for fast generation\npipe.load_lora_weights(\"latent-consistency\u002Flcm-lora-sdxl\")\npipe.scheduler = LCMScheduler.from_config(pipe.scheduler.config)\npipe.fuse_lora()\n\n# Generate in ~1 second\nimage = pipe(\n    \"A beautiful landscape\",\n    num_inference_steps=4,\n    guidance_scale=1.0\n).images[0]\n```\n\n## Common issues\n\n**CUDA out of memory:**\n```python\n# Enable memory optimizations\npipe.enable_model_cpu_offload()\npipe.enable_attention_slicing()\npipe.enable_vae_slicing()\n\n# Or use lower precision\npipe = DiffusionPipeline.from_pretrained(model_id, torch_dtype=torch.float16)\n```\n\n**Black\u002Fnoise images:**\n```python\n# Check VAE configuration\n# Use safety checker bypass if needed\npipe.safety_checker = None\n\n# Ensure proper dtype consistency\npipe = pipe.to(dtype=torch.float16)\n```\n\n**Slow generation:**\n```python\n# Use faster scheduler\nfrom diffusers import DPMSolverMultistepScheduler\npipe.scheduler = DPMSolverMultistepScheduler.from_config(pipe.scheduler.config)\n\n# Reduce steps\nimage = pipe(prompt, num_inference_steps=20).images[0]\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom pipelines, fine-tuning, deployment\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues and solutions\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Fdiffusers\n- **Repository**: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Fdiffusers\n- **Model Hub**: https:\u002F\u002Fhuggingface.co\u002Fmodels?library=diffusers\n- **Discord**: https:\u002F\u002Fdiscord.gg\u002Fdiffusers\n",{"name":5,"author":49,"license":15,"version":50,"metadata":51,"platforms":58,"description":7,"dependencies":59},"Orchestra Research","1.0.0",{"hermes":52},{"tags":53},[26,27,54,55,56,57],"Diffusers","Text-to-Image","Multimodal","Computer Vision",[42,43,41],[60,61,62,63],"diffusers>=0.30.0","transformers>=4.41.0","accelerate>=0.31.0","torch>=2.0.0","main","0d1434f89f4bc6b07e9d272accd8c1013768820f","registry\u002Fskills\u002Fstable-diffusion\u002Fvariants\u002Fhermes-agent-optional",0,"https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills","https:\u002F\u002Fgithub.com\u002Fzapabob","The Open University of JAPAN　2019-now\r\n\r\nTokyo University of Science　2007-2010","2026-10-26 16:29:01",{"source":8,"skillName":5,"commands":73,"prompt":83,"zipAvailable":84},[74,77,80],{"tool":75,"command":76},"npx","npx skills add zapabob\u002FSkills --skill stable-diffusion-image-generation",{"tool":78,"command":79},"bunx","bunx skills add zapabob\u002FSkills --skill stable-diffusion-image-generation",{"tool":81,"command":82},"pnpm","pnpm dlx skills add zapabob\u002FSkills --skill stable-diffusion-image-generation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fstable-diffusion\u002Fvariants\u002Fhermes-agent-optional\u002FSKILL.md",true,[86,92],{"path":87,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",17690,"https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fstable-diffusion\u002Fvariants\u002Fhermes-agent-optional\u002Freferences\u002Fadvanced-usage.md",{"path":93,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Ftroubleshooting.md",12401,"https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fstable-diffusion\u002Fvariants\u002Fhermes-agent-optional\u002Freferences\u002Ftroubleshooting.md",[97,130,165,185,212,228],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":114,"publishedAt":44},"01M6GJTE1GESGGF9K028Y7753E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fxurl\u002Fvariants\u002Fhermes-agent\u002FSKILL.md",[103,106,109],{"categoryNo":104,"categoryName":105,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":107,"categoryName":108,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":110,"categoryName":111,"taxonomyType":112,"taxonomyTypeDesc":113},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[99,115,43,116,117,42,41,118,119,120,121,122,123,124,125,126,64,127,128,129],"openclaw","cli","github","official","search","https","social-media","api","Media","hermes","hermes agent","twitter","social","via","post",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":147,"publishedAt":44},"01M6GJT8S1PXQ8WPXT1HSNBWH2","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fwriting-plans\u002Fvariants\u002Fhermes-agent\u002FSKILL.md",[136,139,142,143,144],{"categoryNo":137,"categoryName":138,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":140,"categoryName":141,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":107,"categoryName":108,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":110,"categoryName":111,"taxonomyType":112,"taxonomyTypeDesc":113},{"categoryNo":145,"categoryName":146,"taxonomyType":112,"taxonomyTypeDesc":113},"01JBSEEDCAT000000000000036","内容创作者",[148,149,150,151,43,152,42,153,41,154,155,156,157,158,159,160,161,162,163,164],"writing","writing plans","plans","design","review","workflow","documentation","tasks","development","code","planning","code-review","subagent","write","superpowers","paths","test-driven-development",{"skillNo":166,"name":167,"nameZh":6,"description":168,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":169,"categories":170,"keywords":172,"publishedAt":44},"01M6GJST0H5X7WHBJ3BZK0DVKH","whisper","OpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes from tiny (39M params) to large (1550M params). Use for speech-to-text, podcast transcription, or multilingual audio processing. Best for robust, multilingual ASR.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fwhisper\u002Fvariants\u002Fhermes-agent-optional\u002FSKILL.md",[171],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[167,43,42,173,174,40,39,175,176,38,177,178,30,179,180,33,181,182,183,184],"openai","speech","ASR","Audio","model","speech recognition","general","multilingual","english","identification","processing","Audio Processing",{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":194,"publishedAt":44},"01M6GJSMRQ8EETZTYMG72P70EA","weights-and-biases","W&B: log ML experiments, sweeps, model registry, dashboards.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fweights-and-biases\u002Fvariants\u002Fhermes-agent\u002FSKILL.md",[191],{"categoryNo":192,"categoryName":193,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000013","分析与可视化",[195,43,196,197,41,198,199,200,201,202,203,177,204,205,206,207,208,209,210,211],"weights and biases","tensorflow","experiments","pytorch","visualization","registry","real-time","tuning","dashboards","experiment","log","time","Experiment Tracking","Model Registry","Hyperparameter Tuning","WandB","Real-Time Visualization",{"skillNo":213,"name":214,"nameZh":6,"description":215,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":216,"categories":217,"keywords":219,"publishedAt":44},"01M6GJS19KDPRY112JTR326S06","watchers","Poll RSS, JSON APIs, and GitHub with watermark dedup.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fwatchers\u002Fvariants\u002Fhermes-agent-optional\u002FSKILL.md",[218],{"categoryNo":107,"categoryName":108,"taxonomyType":21,"taxonomyTypeDesc":22},[214,43,220,117,42,221,222,223,224,225,226,124,125,227,31],"terminal","automation","http","monitoring","cron","json","rss","devops",{"skillNo":229,"name":230,"nameZh":6,"description":231,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":232,"categories":233,"keywords":236,"publishedAt":44},"01M6GJRHJD2A6Q830SWF9W48BC","serving-llms-vllm","vLLM: high-throughput LLM serving, OpenAI API, quantization.","https:\u002F\u002Fgithub.com\u002Fzapabob\u002FSkills\u002Fblob\u002Fmain\u002Fregistry\u002Fskills\u002Fvllm\u002Fvariants\u002Fhermes-agent\u002FSKILL.md",[234,235],{"categoryNo":104,"categoryName":105,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":110,"categoryName":111,"taxonomyType":112,"taxonomyTypeDesc":113},[237,238,239,42,240,173,241,242,243,39,244,122,245,246,247,248,249,250,251,252],"llms","vLLM","serving llms vllm","research","openai api","tensor","Inference Serving","Production","llm serving","High Throughput","PagedAttention","Continuous Batching","Quantization","Tensor Parallelism","high-throughput","throughput"]