wan2gp-operator

Orchestrate Wan2GP installation, VRAM-aware settings, and headless wgp.py execution.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/avalonreset/wan2gp-operator --skill wan2gp-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wan2gp-operator
Source: https://github.com/avalonreset/wan2gp-operator/tree/main
Command: npx skills add https://github.com/avalonreset/wan2gp-operator --skill wan2gp-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires argparse, subprocess, json, pathlib, shutil, platform, re, ffmpeg, ffprobe, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Wan2GP video generation requires fragile, error-prone setup and manual tuning, so runs often fail without a consistent troubleshooting loop; this Skill provides a guided operator layer so you can install, configure, validate, execute, and recover faster.

Core Features & Use Cases

  • VRAM-aware settings composition: generates Wan2GP settings.json from natural-language prompts (including curated model targets) while applying hardware-appropriate defaults.
  • Deterministic headless execution + logs: runs wgp.py --process headlessly with dry-run validation first, structured output, and captured logs for later inspection.
  • Failure diagnosis + learned compatibility state: detects common runtime issues from logs, suggests actionable next steps, and persists “unsupported flag/attention mode” knowledge to reduce repeat failures.
  • AI music video pipeline: analyzes an audio track (BPM/beats/sections), plans beat-aligned shots, generates clips, and assembles an audio-muxed final MP4 using FFmpeg.

Quick Start

Ask your agent: "Assess my machine for Wan2GP, bootstrap it, then compose settings from this prompt and run a dry-run: cinematic rain alley at golden hour, natural city ambience."

Frequently Asked Questions about wan2gp-operator

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

FAQPage Schema
How do I run Wan2GP headlessly from the terminal without manual setup?

You can run Wan2GP headlessly by using an operator layer that orchestrates installation, composes VRAM-aware settings, and executes `wgp.py --process` with dry-run validation. It captures structured logs to diagnose failures and persists compatibility state to prevent repeat errors.

Why does my Wan2GP video generation fail and how do I diagnose the error?

Wan2GP video generation often fails due to fragile manual tuning or unsupported attention backends. This diagnostic layer captures structured runtime logs, detects common failure issues, suggests actionable next steps, and persists unsupported flag knowledge to auto-fallback on future runs.

Can I generate an AI music video with Wan2GP using beat-aligned audio tracks?

Yes, you can generate an AI music video by analyzing an audio track for BPM and sections, planning beat-aligned shots, and generating clips. The pipeline then assembles and audio-muxes the final MP4 output automatically using FFmpeg.

Does Wan2GP support automatic VRAM-aware settings composition for text-to-video?

Yes, Wan2GP supports VRAM-aware settings composition by generating `settings.json` from natural-language prompts while applying hardware-appropriate defaults. This ensures text-to-video, image-to-video, and ACE-Step pipelines run safely within your machine's available memory.

What is the best way to batch process multiple Wan2GP video generations safely?

The best way to batch process Wan2GP video generations is through a guided operator that validates required process inputs, applies dry-run validation, and manages queue processing. It ensures deterministic headless execution and captures logs for every run to diagnose any batch failures.

Do I need FFmpeg installed to assemble Wan2GP music video pipelines?

Yes, you need FFmpeg and ffprobe installed to assemble audio-muxed final MP4 outputs in Wan2GP music video pipelines. The pipeline relies on these dependencies to merge generated beat-aligned video clips with the analyzed audio track.