← Back to Skills Marketplace
chrisliu95

Comfyui Flux

by Chris Liu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
73
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install comfyui-flux
Description
Generate images locally using ComfyUI + Flux.1 Dev model. Zero API cost, strong text rendering. Use when: generating images locally, creating slides/PPT grap...
README (SKILL.md)

ComfyUI Flux.1 Dev — Local Image Generation

Generate images locally via ComfyUI API + Flux.1 Dev. No API cost, excellent text rendering.

Prerequisites

ComfyUI must be running (default port 8200):

# 启动
bash /Users/chrisliu/ComfyUI/start.sh
# 关闭
bash /Users/chrisliu/ComfyUI/stop.sh

Override URL via env: COMFYUI_URL=http://127.0.0.1:8200

Models (already installed):

  • flux1-dev.safetensors (diffusion model)
  • t5xxl_fp8_e4m3fn.safetensors + clip_l.safetensors (text encoders)
  • ae.safetensors (VAE)

Usage

python3 {baseDir}/scripts/flux_generate.py --prompt "PROMPT" [OPTIONS]

Basic

python3 {baseDir}/scripts/flux_generate.py \
  --prompt "A professional presentation slide with title 'AI Revolution' in bold white text on dark gradient background"

Custom Size (e.g. 16:9 for PPT slides)

python3 {baseDir}/scripts/flux_generate.py \
  --prompt "..." \
  --width 1344 --height 768

Parameters

Parameter Default Description
--prompt (required) Image description
--negative "" Negative prompt
--width 1024 Image width
--height 1024 Image height
--steps 20 Sampling steps (more = better but slower)
--cfg 1.0 CFG scale (Flux works best at 1.0)
--seed random Reproducibility seed
--output auto Output path (default: generated-images/flux-{ts}.png)
--timeout 600 Max wait seconds

Common Sizes

Use Case Size Flag
Square 1024×1024 (default)
PPT 16:9 1344×768 --width 1344 --height 768
Portrait 768×1344 --width 768 --height 1344
Landscape 1344×768 --width 1344 --height 768

PuLID Face-Consistent Generation

Generate images with a reference face using PuLID-Flux (zero API cost, zero censorship):

python3 {baseDir}/scripts/pulid_generate.py \
  --prompt "PROMPT" \
  --ref-image path/to/face.jpg [OPTIONS]

Basic (face-consistent portrait)

python3 {baseDir}/scripts/pulid_generate.py \
  --prompt "a girl sitting in a cafe, warm afternoon light, casual outfit" \
  --ref-image avatars/kimi.jpg

Custom size + weight

python3 {baseDir}/scripts/pulid_generate.py \
  --prompt "a girl on the beach at sunset, wearing a sundress" \
  --ref-image avatars/kimi.jpg \
  --width 1024 --height 1024 \
  --weight 1.2

PuLID Parameters

Parameter Default Description
--prompt (required) Image description
--ref-image (required) Reference face image path
--negative "" Negative prompt
--width 768 Image width
--height 1024 Image height (portrait default)
--steps 10 Sampling steps (PuLID works well with fewer)
--cfg 3.5 Guidance scale
--seed random Reproducibility seed
--weight 1.0 Face similarity weight (0.0-5.0, higher = more similar)
--start-at 0.0 PuLID start timestep
--end-at 1.0 PuLID end timestep
--output auto Output path (default: generated-images/pulid-{ts}.png)
--timeout 600 Max wait seconds

PuLID Notes

  • Default portrait orientation (768×1024) — good for face shots
  • --weight 1.0 is balanced; increase to 1.2-1.5 for stronger likeness
  • --steps 10 is enough for PuLID; increase to 20 for more detail
  • First run is slower (loads PuLID + InsightFace + EVA-CLIP models)
  • No content censorship — can generate anything locally

Strengths vs API (qwen-image)

  • ✅ Free — no API cost
  • ✅ Excellent text/typography rendering (great for slides!)
  • ✅ High detail and consistency
  • ⚠️ Slower on Mac (~1-3 min per image)
  • ❌ No native face-consistency (use PuLID/IPAdapter for that)

Output

Prints MEDIA:\x3Cpath> — auto-attached to chat reply. Default saves to generated-images/.

Troubleshooting

If ComfyUI is not running, the script exits with an error and prints startup instructions.

Usage Guidance
This skill appears to do what it claims: talk to a ComfyUI instance on your machine and save generated images. Before installing or running it: - Verify which port your local ComfyUI uses (SKILL.md mentions 8200 in one place and 8188 in another) and set COMFYUI_URL explicitly if needed. The scripts default to 127.0.0.1:8200 in code but some messages/docstrings reference 8188, which will confuse runs if your ComfyUI is on a different port. - Ensure COMFYUI_URL is not pointed at a remote host unless you intentionally want to send images and reference files there — if pointed remotely, the skill will upload files (including any --ref-image path) to that host, which could leak sensitive data. - Do not pass paths to sensitive files as --ref-image; the script will read and upload whatever file you supply. - The SKILL.md contains a user-specific startup path (/Users/chrisliu/ComfyUI) — that is just an example and should be replaced with your actual ComfyUI start command. - Be aware the PuLID functionality is explicitly uncensored (can generate any content); follow your local policies and laws when generating images. If you want higher assurance, inspect and run the included scripts locally before giving the skill runtime access, and run ComfyUI in a restricted environment or container.
Capability Analysis
Type: OpenClaw Skill Name: comfyui-flux Version: 1.0.0 The skill bundle provides a legitimate interface for local image generation using ComfyUI and the Flux.1 model. The Python scripts (flux_generate.py and pulid_generate.py) communicate exclusively with a local API endpoint (defaulting to localhost:8200) to submit image generation workflows and download the resulting files. No evidence of data exfiltration, unauthorized network access, or malicious code execution was found; the logic is consistent with the stated purpose of providing a private, local alternative to cloud-based image APIs.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md and the two included Python scripts consistently implement local image generation through ComfyUI (Flux.1 Dev and PuLID). No unrelated services or credentials are requested. Note: SKILL.md and docstrings disagree on default ports (8188 vs 8200) and the prerequisites include a user-specific path (/Users/chrisliu/ComfyUI), which is sloppy and may confuse users.
Instruction Scope
Instructions and scripts operate within the expected scope: they talk to ComfyUI endpoints (/system_stats, /prompt, /history, /view, /upload/image), save generated images to a local folder, and upload user-supplied reference images for PuLID. They do not read arbitrary system state or other credentials. Important caveat: the scripts use the COMFYUI_URL environment variable — if that is set to a remote host, reference images and prompts will be sent to that host, enabling data exfiltration. SKILL.md documents COMFYUI_URL override, so this behavior is explicit but should be treated carefully.
Install Mechanism
There is no install spec and no external downloads; the skill is instruction-plus-scripts only, which is the lowest-risk install model. The included Python scripts use only stdlib modules and make HTTP requests to the configured ComfyUI endpoint.
Credentials
The skill declares no required environment variables; in code it reads COMFYUI_URL as an optional override (documented). This is proportionate. However, because COMFYUI_URL controls the destination for uploads and prompt submission, setting it to a non-local host would route image data (including any reference image files you provide) off your machine. The scripts can read and POST any file path you pass to --ref-image, so avoid pointing to sensitive files.
Persistence & Privilege
The skill does not request persistent or elevated platform privileges (always:false). It does not modify other skills or system-wide agent settings. It simply runs scripts that interact with ComfyUI when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install comfyui-flux
  3. After installation, invoke the skill by name or use /comfyui-flux
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of comfyui-flux for local image generation via ComfyUI + Flux.1 Dev model. - Supports both standard and PuLID face-consistent image generation through CLI scripts. - Zero API cost, strong text/typography rendering—ideal for PPT slides and graphics. - Works with preinstalled models; customizable parameters for prompt, size, quality, and output path. - Requires ComfyUI running locally; comprehensive usage instructions and troubleshooting included.
Metadata
Slug comfyui-flux
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Comfyui Flux?

Generate images locally using ComfyUI + Flux.1 Dev model. Zero API cost, strong text rendering. Use when: generating images locally, creating slides/PPT grap... It is an AI Agent Skill for Claude Code / OpenClaw, with 73 downloads so far.

How do I install Comfyui Flux?

Run "/install comfyui-flux" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Comfyui Flux free?

Yes, Comfyui Flux is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Comfyui Flux support?

Comfyui Flux is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Comfyui Flux?

It is built and maintained by Chris Liu (@chrisliu95); the current version is v1.0.0.

💬 Comments