flux-kontext

Edit images with Flux 1 Kontext Pro via the RunComfy CLI using single-image prompts.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/brillianodhiya/VisionScript --skill flux-kontext-brillianodhiya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flux-kontext
Source: https://github.com/brillianodhiya/VisionScript/tree/main/.agents/skills/flux-kontext
Command: npx skills add https://github.com/brillianodhiya/VisionScript --skill flux-kontext-brillianodhiya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @runcomfy/cli.

What problem does it solve? Performing precise local edits on an existing image (changing an object, swapping label text, adding an accessory) without regenerating the whole scene is hard with generic text-to-image models. This Skill routes those requests to Black Forest Labs' Flux 1 Kontext Pro on the RunComfy Model API, with documented prompting patterns that preserve the source image's identity. ## Core Features & Use Cases - Single-reference local image editing: Pass one source image URL plus a declarative prompt to blackforestlabs/flux-1-kontext/pro/edit and get a high-fidelity edited result. - Preservation-first prompting guidance: Built-in patterns like "Keep [identity/pose/framing] unchanged" reduce drift, plus seed support for reproducible variant series. - Model routing advice: Clear rules for when to use Nano Banana Edit (multi-image batches), GPT Image 2 edit (multilingual text), or Flux 2 Klein (generation from scratch) instead. - Use Case: A brand designer needs the label text on a product bottle changed from "ALPHA" to "AURA" while keeping the bottle, lighting, and table identical — one CLI call with a preservation-led prompt produces the edit. ## Quick Start Ask the AI to edit an image with Flux Kontext, for example: "Use Flux Kontext to add an orange umbrella to this portrait while keeping the person's face and pose unchanged."

Frequently Asked Questions about flux-kontext

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

FAQPage Schema
How do I edit an image with Flux Kontext on RunComfy?▼

Run `runcomfy run blackforestlabs/flux-1-kontext/pro/edit` with a JSON input containing a prompt and a publicly fetchable image URL, plus an output directory. Lead the prompt with what to keep unchanged, then state the single edit.

Flux Kontext vs Nano Banana Edit: which should I use?▼

Use Flux Kontext for single-image precise local edits with strong identity preservation. Use Nano Banana Edit when you need batch edits across 1–20 images or multi-image reference flows, since Kontext accepts only one source image.

What prompting style works best for Flux Kontext image edits?▼

Use one declarative, imperative instruction per pass, such as "She is now holding an orange umbrella and smiling." Start with a preservation clause like "Keep the face, pose, and clothing unchanged," and split compound edits into sequential passes to avoid drift.

Can Flux Kontext edit multiple images or generate from scratch?▼

No. Flux Kontext accepts exactly one source image per request. For multi-image batches route to Nano Banana Edit, and for text-to-image generation without a source image use Flux 2 Klein instead.

Why does my Flux Kontext edit drift from the source image?▼

Drift usually comes from compound prompts asking for several changes at once or passive-voice instructions. Split the edit into sequential single-instruction passes and explicitly state what must remain unchanged at the start of the prompt.

What do RunComfy CLI exit codes 75 and 77 mean?▼

Exit code 75 indicates a retryable failure such as a timeout or HTTP 429 rate limit. Exit code 77 means you are not signed in or the token was rejected; run `runcomfy login` or set a valid RUNCOMFY_TOKEN environment variable.