
Flux Kontext
- 355k installs
- 31 repo stars
- Updated May 15, 2026
- agentspace-so/runcomfy-agent-skills
Flux Kontext is a Claude skill that edits a single image with Black Forest Labs' Flux 1 Kontext Pro model through the local RunComfy CLI.
About
Edits a single source image with Black Forest Labs' Flux 1 Kontext Pro model, invoked through the local RunComfy CLI. A developer reaches for it for targeted local edits that keep the source identity intact, like adding an object to a portrait or swapping brand text on a label. It bundles the model's documented prompting patterns and tells you when to route to a sibling model for multi-image or embedded-text edits.
- Edits one source image with Black Forest Labs Flux 1 Kontext Pro via the RunComfy CLI
- Bundles preservation-first prompting patterns for precise local edits
- Routes to Nano Banana Edit / GPT Image 2 / Flux 2 Klein for multi-image or text-heavy jobs
Flux Kontext by the numbers
- 355,105 all-time installs (skills.sh)
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
flux-kontext capabilities & compatibility
Skill is MIT-licensed; needs a RunComfy account and GPU generation is billed by RunComfy.
- Capabilities
- image editing · brand asset editing
- Use cases
- image generation
- Runs
- Local or remote
- Pricing
- Bring your own API key
What flux-kontext says it does
single-reference precise local image edit
Strong prompt control, consistent outputs, high fidelity.
For multi-image or web-grounded edits, route to Nano Banana Edit.
npx skills add https://github.com/agentspace-so/runcomfy-agent-skills --skill flux-kontextAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 355k |
|---|---|
| repo stars | ★ 31 |
| Security audit | 2 / 3 scanners passed |
| Last updated | May 15, 2026 |
| Repository | agentspace-so/runcomfy-agent-skills ↗ |
How do you run Flux Kontext Pro edits on RunComfy?
Make a precise single-image local edit (swap label text, add an object) while preserving the source identity.
Who is it for?
Single-image precise local edits that must preserve source identity
Skip if: Multi-image fanout or editing embedded/multilingual text in an image
When should I use this skill?
User says 'flux kontext', 'kontext', or asks to edit one image with this model
What you get
High-fidelity edited image, Flux Kontext schema parameters, and runcomfy CLI command.
- edited image file downloaded to output-dir
By the numbers
- 4 input schema fields (prompt, image, aspect_ratio, seed)
- single source image per call
Files
Flux Kontext Pro — Pro Pack on RunComfy
runcomfy.com · Model page · GitHub
Black Forest Labs' Flux 1 Kontext Pro — single-reference precise local image edit — hosted on the RunComfy Model API. Strong prompt control, consistent outputs, high fidelity.
npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -gWhen to pick this model (vs siblings)
| You want | Use |
|---|---|
| Single-image precise local edit ("she's now holding X") | Flux Kontext |
| High-fidelity preservation of source identity | Flux Kontext |
| Batch edits across 1–20 images | Nano Banana Edit |
| Edit multilingual / embedded text in image | GPT Image 2 edit |
| Generate from scratch, no source image | Flux 2 Klein |
If the user said "Flux Kontext" / "kontext" / "BFL Kontext" explicitly, route here regardless.
Prerequisites
1. RunComfy CLI — npm i -g @runcomfy/cli 2. RunComfy account — runcomfy login opens a browser device-code flow. 3. CI / containers — set RUNCOMFY_TOKEN=<token> instead of runcomfy login.
Endpoints + input schema
blackforestlabs/flux-1-kontext/pro/edit
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
prompt | string | yes | — | Single declarative edit instruction. |
image | string | yes | — | Single source image URL (publicly fetchable HTTPS). |
aspect_ratio | enum | no | (input) | Pick from supported W:H options on the model page. |
seed | int | no | — | Reuse for variant comparisons. |
The schema is intentionally minimal — Kontext leans on prompt + single ref. For multi-image or web-grounded edits, route to Nano Banana Edit.
How to invoke
Default — local edit, preserve everything else:
runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
--input '{
"prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
"image": "https://.../portrait.jpg"
}' \
--output-dir <absolute/path>With seed for reproducible variant series:
runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
--input '{
"prompt": "Keep the bottle, label, and lighting unchanged. Replace the brand text on the label from \"ALPHA\" to \"AURA\".",
"image": "https://.../bottle.jpg",
"seed": 42
}' \
--output-dir <absolute/path>Prompting — what actually works
One declarative instruction. Kontext shines on prompts shaped like the docs example: "She is now holding an orange umbrella and smiling". Imperative mood, single change.
Preservation first. Lead with "Keep [identity / pose / framing / brand] unchanged." Then the change. Models honor what's stated up front.
Single ref only — pick the right one. No multi-image fanout here
Related skills
How it compares
Pick flux-kontext when one reference image needs surgical local edits; pick Nano Banana Edit or GPT Image 2 edit for batch or in-image text workflows.
FAQ
What CLI endpoint does flux-kontext call?
flux-kontext runs runcomfy run blackforestlabs/flux-1-kontext/pro/edit through the local RunComfy CLI. The skill supplies single-image-plus-prompt schema and documented prompting patterns.
When should developers use flux-kontext over Nano Banana Edit?
flux-kontext targets Flux 1 Kontext Pro for single-reference precise local edits with strong prompt control. Nano Banana Edit fits batch edits up to 20 images or identity-preserving multi-input workflows.
Is Flux Kontext safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.