lightflow-flux-text-to-image-router

name	LightFlow FLUX Text To Image Router
description	Use this skill when working with the lightflow.flux_text_to_image_router workflow or routing image generation between real FLUX and preview runtimes.
version	0.1.0

LightFlow FLUX Text To Image Router

Use lightflow.flux_text_to_image_router to route generation to the real FLUX workflow when use_flux=true, or to the deterministic preview workflow otherwise.

The source definition now uses the canonical workflow! { name, description, ... } form. This source-only DSL migration does not change execution behavior or the input/output contract below.

Workflow

• Workflow id: lightflow.flux_text_to_image_router
• Inputs: use_flux, prompt, negative, width, height, seed, steps, guidance, output_path.
• Outputs: image, image_path.
• Branches: lightflow.flux_text_to_image or lightflow.flux_preview_text_to_image.
• Node Schema: output ports are image artifacts; use_flux is a toggle; generation controls expose editor ranges.

Routing

Use use_flux=false for fast local preview checks. Use use_flux=true only after syncing model requirements for lightflow.flux_text_to_image.

When use_flux=true, the selected production leaf enables its own validated Cargo native feature. The root LightFlow binary needs no FLUX feature and cross-request model residency is not guaranteed.

To use the external fallback instead:

export LIGHTFLOW_SD_CLI=/path/to/stable-diffusion.cpp/build/bin/sd-cli
export LIGHTFLOW_FLUX_RUNNER="$PWD/scripts/sd-cli-flux-runner"

Keep router smoke tests small. Native execution is the performance path; the external fallback is process-per-call and should be used for compatibility checks.

Usage

lfw run lightflow.flux_text_to_image_router \
  -i use_flux=false \
  -i prompt='"fast preview"' \
  -i output_path='"out/router-preview.png"'

Real backend smoke test:

export LIGHTFLOW_FLUX_BACKEND=native
lfw run lightflow.flux_text_to_image_router \
  -i use_flux=true \
  -i prompt='"router real FLUX smoke test, blue sphere"' \
  -i width=128 \
  -i height=96 \
  -i seed=13 \
  -i steps=1 \
  -i guidance=1.0 \
  -i output_path='"out/router-real.png"'

Validation

lfw node test lightflow.flux_text_to_image_router

API Usage

Start lfw serve, then call the workflow through the shared HTTP run contract. Adjust inputs to match the workflow contract above.

curl -sS -X POST http://127.0.0.1:5174/workflows/lightflow.flux_text_to_image_router/run \
  -H 'content-type: application/json' \
  -d '{"inputs":{}}'