Unified CLI (`opentryon`)

Once OpenTryOn is installed (pip install -U opentryon or pip install -e .; v0.0.5+ recommended), every adapter in the repo is available through a single opentryon command with three levels of control: service → model → parameters.

opentryon <service> --model <model> [params...]

service: what kind of task -- vton, generate, edit, understand, video-generate, bg-remove
model: which adapter/provider to use for that service, e.g. --model flux-vto
parameters: model-specific flags (image inputs, prompts, sampling knobs, etc.)

Services and Models

Service	What it does	Models
`vton`	Virtual try-on: compose a garment onto a person image	`flux-vto`, `google-vton`, `outfitanyone-plus`, `photoroom-vton`, `photoroom-virtual-model`, `nova-canvas`, `kling-ai`, `segmind`, `p-image-tryon`, `fashn-tryon-max`, `fashn-tryon-v1.6`, `nano-banana-2-lite`, `qwen-image`, `qwen-image-local`, `leffa` (local), `catvton` (local), `muse-image`
`generate`	Text-to-image generation	`nano-banana`, `nano-banana-pro`, `nano-banana-2`, `flux2-pro`, `flux2-flex`, `flux2-turbo` (local), `gpt-image`, `gpt-image-2.5`, `gpt-image-2.5-sunburst`, `luma-image`, `seedream`, `ideogram`, `grok-imagine-image`, `p-image`, `p-image-ideogram`, `qwen-image`, `qwen-image-local` (local), `muse-image`
`edit`	Image editing (image + instruction → image)	`nano-banana`, `nano-banana-pro`, `nano-banana-2`, `flux2-pro`, `flux2-flex`, `flux2-turbo` (local), `gpt-image`, `gpt-image-2.5`, `gpt-image-2.5-sunburst`, `seedream`, `p-image-edit`, `p-image-upscale`, `qwen-image`, `qwen-image-local` (local), `muse-image`
`understand`	Image/video understanding	`kimi-k2.6`, `kimi-k2.7-code`, `kimi-k3`, `kimi-vl` (local), `qwen3.8-max`, `qwen3.8-omni-flash`, `qwen3.8` (local), `glm-5.3-flashx`, `hy4-preview`, `hy4-preview-local`, `nemotron-omni`, `cosmos3-reasoner`, `llava-next` (local), `ternary-bonsai-2-27b` (local server)
`video-generate`	Text/image-to-video generation	`veo`, `sora`, `luma-video`, `luma-ray-3.2`, `seedance`, `kling-v3`, `kling-v3-omni`, `kling-v2-5-turbo`, `grok-imagine-video`, `gemini-omni`, `p-video`, `p-video-2-pro`, `p-video-replace`, `p-video-avatar`, `p-video-animate`, `ltx-2.5-api`, `ltx-2.5`, `hailuo-2.3`, `minimax-h3`, `minimax-h3-max`, `fal-h3-max`, `fal-h3-max-lipsync`, `minimax-h3-local`, `wan-api`, `wan-3.0`, `wan-2.2`, `runway-gen4.5`, `cosmos3`
`bg-remove`	Background removal	`ben2` (local)

Models marked "local" run on your own GPU and require pip install opentryon[local]; everything else calls a cloud API and needs the corresponding API key set in your environment (see Configuration).

Discovering Flags

Every level of the CLI is self-documenting:

opentryon --help                              # list services
opentryon understand --help                   # list models for a service
opentryon understand --model kimi-k2.6 --help # list that model's parameters

Examples

# Virtual try-on
opentryon vton --model flux-vto \
  --person-image model.png --garment-image garment.png

# Google Vertex dedicated try-on (ADC + GOOGLE_CLOUD_PROJECT; not GEMINI_API_KEY)
opentryon vton --model google-vton \
  --person-image model.png --garment-image garment.png

# Alibaba OutfitAnyone-Plus (Beijing DASHSCOPE_API_KEY; not Qwen-Image)
opentryon vton --model outfitanyone-plus \
  --person-image model.png --garment-image garment.png

# Photoroom shopper try-on / catalog virtual model
opentryon vton --model photoroom-vton \
  --person-image selfie.jpg --garment-image dress.jpg
opentryon vton --model photoroom-virtual-model \
  --garment-image flatlay.jpg --preset-model avery

# Text-to-image
opentryon generate --model nano-banana-pro \
  --prompt "A fashion model wearing elegant evening wear" --resolution 4K

# Image editing
opentryon edit --model gpt-image-2.5-sunburst \
  --images person.jpg --prompt "Change the jacket to black leather"

# Image/video understanding (Kimi K2.6, general-purpose -- not fashion-only)
opentryon understand --model kimi-k2.6 \
  --image garment.jpg --prompt "Describe this outfit."
opentryon understand --model kimi-k2.6 \
  --video runway_clip.mp4 --prompt "Summarize the styling shown."

# Coding-focused multimodal understanding
opentryon understand --model kimi-k2.7-code \
  --image ui_mockup.png --prompt "Write the HTML/CSS for this design."

# Kimi K3 (flagship multimodal reasoning)
opentryon understand --model kimi-k3 \
  --image garment.jpg \
  --prompt "Write a marketplace-ready title and bullet points." \
  --reasoning-effort high

# Open-weight local understanding (no API key, needs a GPU)
opentryon understand --model kimi-vl --image garment.jpg

# Qwen3.8-Max (DashScope) + open-weight Qwen3.8-27B
# Native multimodal understand: thinking + reasoning_effort on Max
opentryon understand --model qwen3.8-max \
  --image garment.jpg --prompt "Describe this outfit." \
  --reasoning-effort medium
opentryon understand --model qwen3.8 --image garment.jpg

# Qwen3.8-Omni-Flash (same DASHSCOPE_API_KEY): adds --audio
opentryon understand --model qwen3.8-omni-flash \
  --audio voice_note.wav --prompt "What is being said?"

# GLM-5.3-FlashX (Zhipu / Z.ai, ZAI_API_KEY)
opentryon understand --model glm-5.3-flashx \
  --image garment.jpg --prompt "Describe this outfit."

# Ternary Bonsai 2 27B (local llama.cpp/MLX server, no cloud key)
opentryon understand --model ternary-bonsai-2-27b \
  --prompt "Explain ternary quantization in two sentences."

# Tencent Hy4 preview (TokenHub LLM; optional --image)
opentryon understand --model hy4-preview \
  --prompt "Write a 3-sentence lookbook caption for a linen trench."
# Local vLLM/SGLang twin (HY4_BASE_URL, no TokenHub key)
opentryon understand --model hy4-preview-local --prompt "Hello"

# NVIDIA NIM (same NVIDIA_API_KEY): Nemotron Omni + Cosmos 3 Reasoner
opentryon understand --model nemotron-omni \
  --image garment.jpg --prompt "Describe this outfit."
opentryon understand --model cosmos3-reasoner \
  --video lookbook.mp4 --prompt "What physical interactions occur?"

# Qwen-Image 3.0 (same DASHSCOPE_API_KEY): generate / edit / VTON
opentryon generate --model qwen-image \
  --prompt "editorial lookbook, linen trench on a sunlit terrace"
opentryon edit --model qwen-image \
  --images person.jpg --prompt "Change the jacket to black leather"
opentryon vton --model qwen-image \
  --person-image model.jpg --garment-image garment.jpg \
  --garment-description "olive green bomber jacket"

# Qwen-Image local Diffusers (needs GPU + opentryon[local])
opentryon generate --model qwen-image-local \
  --prompt "editorial lookbook, linen trench" --aspect-ratio 16:9
opentryon vton --model qwen-image-local \
  --person-image model.jpg --garment-image garment.jpg

# Dedicated local VTON (needs GPU + opentryon[local])
opentryon vton --model leffa --person-image model.jpg --garment-image garment.jpg
opentryon vton --model catvton --person-image model.jpg --garment-image garment.jpg

# Text-to-video
opentryon video-generate --model veo \
  --prompt "A model walking a runway in slow motion" --duration 6

# Seedance 2.5 / Kling 3.0 / Ray 3.2 / Grok Imagine Video / Pruna P-Video
opentryon video-generate --model seedance --prompt "10s lookbook walk" --duration 10
# Seedance 2.5 ModelArk id is dreamina-seedance-2-5-260628 (--model-version seedance-2-5)
opentryon video-generate --model kling-v3 --prompt "atelier pan" --mode pro --sound on
opentryon video-generate --model luma-ray-3.2 --prompt "dolly through mist" --resolution 720p
opentryon video-generate --model grok-imagine-video --prompt "cinematic push-in" --duration 6
opentryon video-generate --model p-video --prompt "runway walk, soft light" --duration 5
opentryon video-generate --model p-video-2-pro --prompt "runway walk, soft light" --duration 8 --mode speed
opentryon video-generate --model p-video-replace --video clip.mp4 --images identity.jpg
opentryon video-generate --model p-video-avatar --image portrait.jpg --voice-script "Hello from the showroom."
opentryon video-generate --model p-video-animate --video driver.mp4 --image subject.jpg
opentryon video-generate --model ltx-2.5-api --prompt "runway walk, soft light" --duration 8 --resolution 1920x1080
opentryon video-generate --model ltx-2.5 --prompt "runway walk at dusk, camera tracking" --width 960 --height 544 --num-frames 121
opentryon video-generate --model hailuo-2.3 --prompt "runway walk [Tracking shot]" --duration 6 --resolution 1080P
opentryon video-generate --model minimax-h3 --prompt "runway walk at dusk" --duration 5 --resolution 2K --ratio 16:9
opentryon video-generate --model minimax-h3-max --prompt "runway walk at dusk" --duration 5 --resolution 768P --ratio 16:9
opentryon video-generate --model fal-h3-max --prompt "runway walk at dusk" --duration 5 --resolution 768P --ratio 16:9
opentryon video-generate --model fal-h3-max --prompt "Image 1 is the model. Keep her identity." --reference-image look.jpg
opentryon video-generate --model fal-h3-max-lipsync --image portrait.jpg --audio line.wav --resolution 1080P
opentryon video-generate --model minimax-h3-local --prompt "runway walk at dusk" --width 960 --height 544 --num-frames 124
opentryon video-generate --model wan-api --prompt "runway walk" --duration 5 --resolution 720P
opentryon video-generate --model wan-3.0 --prompt "runway walk at dusk" --duration 8 --resolution 720P
opentryon video-generate --model wan-2.2 --prompt "runway walk at dusk" --num-frames 81
opentryon video-generate --model runway-gen4.5 --prompt "runway walk through mist" --duration 5 --ratio 1280:720
opentryon video-generate --model cosmos3 --prompt "A model walks a concrete runway at dusk." --resolution 720

# Seedream / Ideogram / Grok Imagine Image / Pruna P-Image
opentryon generate --model seedream --prompt "editorial sneaker still" --size 2K
opentryon generate --model ideogram --prompt 'Poster "SUMMER 2026"' --rendering-speed QUALITY
opentryon generate --model grok-imagine-image --prompt "street-art collage" --aspect-ratio 16:9
opentryon generate --model p-image --prompt "luxury knitwear flatlay" --aspect-ratio 1:1
opentryon generate --model p-image-ideogram --prompt 'Poster "ATELIER NOIR"' --thinking high --image-size 2K
opentryon generate --model muse-image --prompt "editorial runway still, dusk" --size 1024x1536
opentryon edit --model muse-image --images look.jpg --prompt "black leather jacket, keep pose"
opentryon vton --model muse-image --person-image model.jpg --garment-image garment.png
opentryon edit --model p-image-edit --images photo.jpg --prompt "clean studio background"
opentryon edit --model p-image-upscale --image photo.jpg --target 8

# Background removal
opentryon bg-remove --model ben2 --image product.jpg --refine

Every command accepts -o/--output-dir (default: outputs/) and --dry-run (print the resolved adapter call without invoking the API/GPU):

opentryon vton --model flux-vto \
  --person-image model.png --garment-image garment.png --dry-run

Local (GPU-only) Models

Local models (flux2-turbo, kimi-vl, qwen3.8, qwen-image-local, leffa, catvton, llava-next, ben2, ltx-2.5, minimax-h3-local, wan-2.2) need the local extra:

pip install opentryon[local]

Running a local model without it prints an install hint instead of a raw stack trace:

✗ 'Kimi-VL (open-weight, local)' requires local ML dependencies that aren't installed.
  Install them with: pip install opentryon[local]

Services and Models​

Discovering Flags​

Examples​

Local (GPU-only) Models​

See Also​

Services and Models

Discovering Flags

Examples

Local (GPU-only) Models

See Also