remesher

An agent harness that uses a small Typer CLI to submit ComfyUI API prompts, stream async progress via WebSocket, and download generated outputs.

---

What it does

• Reads ComfyUI server URL from config.json
• Submits prompt JSON to POST /prompt
• Supports runtime overrides for key fields:
  • positive text prompt
  • mesh seed
  • target face count
  • file name prefix
  • texture seed
• Streams progress via GET /ws?clientId=... when a client ID is available
• Waits for completion using GET /history/{prompt_id} (with queue polling fallback)
• Auto-downloads .glb output via GET /view

---

Requirements

• Python + uv
• ComfyUI server reachable from this machine
• A ComfyUI build with required nodes/models installed and running at server_url, such as:
  • michaelgold/comfy3d, or
  • another ComfyUI setup that includes qwen-image-2512 and Trellis2

---

Quick start

cd /Users/mg/.openclaw/workspace/comfy-prompt-cli
uv sync
uv run comfy-prompt-cli config init --force

Default config.json:

{
  "server_url": "http://localhost:8188/"
}

---

Commands

1) Health check

uv run comfy-prompt-cli health

2) Text to image (qwen_image_2512)

uv run comfy-prompt-cli text-to-image \
  --prompt "A cinematic portrait of a fox in rain"

3) Image + text to image (qwen_image_edit_2511)

uv run comfy-prompt-cli image-text-to-image \
  --image path/to/input.png \
  --prompt "Put this character in a futuristic city at sunset"

4) Image to GLB (img_to_trellis2)

uv run comfy-prompt-cli image-to-glb \
  --image path/to/input.png \
  --mesh-seed 12345 \
  --target-face-num 800000 \
  --filename-prefix my_mesh \
  --texture-seed 67890

5) Rig GLB (rig_glb_mia)

uv run comfy-prompt-cli rig-glb \
  --mesh wrestler_multi_trellis.glb \
  --glb-name rigged

6) Text to GLB (end-to-end)

uv run comfy-prompt-cli text-to-glb \
  --prompt "A stylized wrestler character, full body, neutral pose"

7) Text to Rigged GLB (end-to-end)

uv run comfy-prompt-cli text-to-rigged-glb \
  --prompt "A stylized wrestler character, full body, neutral pose"

8) Submit prompt JSON

uv run comfy-prompt-cli send path/to/prompt_api.json

9) Submit with overrides

uv run comfy-prompt-cli send path/to/prompt_api.json \
  --prompt "A 3d cartoon astronaut in a t-pose" \
  --mesh-seed 12345 \
  --target-face-num 800000 \
  --filename-prefix astronaut \
  --texture-seed 67890

10) Wait for completion + download GLB

uv run comfy-prompt-cli wait <prompt_id> --out-dir downloads

If you want live /ws progress for an already-submitted prompt, pass the same client_id used when submitting:

uv run comfy-prompt-cli wait <prompt_id> --client-id <client_id> --out-dir downloads

11) One-shot full pass (submit + wait + download)

uv run comfy-prompt-cli run path/to/prompt_api.json \
  --prompt "A 3d cartoon astronaut in a t-pose" \
  --mesh-seed 12345 \
  --target-face-num 800000 \
  --filename-prefix astronaut \
  --texture-seed 67890 \
  --out-dir downloads

12) Dry run (build payload only)

uv run comfy-prompt-cli send path/to/prompt_api.json --dry-run

---

Typical workflow

# Text -> image
uv run comfy-prompt-cli text-to-image --prompt "A 3d cartoon astronaut in a t-pose"

# Image + text -> image
uv run comfy-prompt-cli image-text-to-image \
  --image path/to/input.png \
  --prompt "Make this look like a fashion editorial"

# Image -> GLB
uv run comfy-prompt-cli image-to-glb \
  --image path/to/input.png \
  --mesh-seed 12345 \
  --target-face-num 800000 \
  --filename-prefix astronaut \
  --texture-seed 67890

---

Input format notes

send expects ComfyUI API prompt JSON.

Accepted:

• direct API prompt object ({"node_id": {...}}), or
• wrapper with top-level prompt key ({"prompt": {...}})

Rejected:

• UI workflow export format with top-level nodes + links

If you pass workflow export JSON, CLI will show a clear error telling you to export/copy API prompt JSON.

Image-based commands (image-text-to-image, image-to-glb) accept a local image path. The CLI uploads that image to ComfyUI input storage before submitting the workflow.

---

Examples included

• examples/qwen_image_2512.json
  Text-to-image API prompt workflow
• examples/qwen_image_edit_2511.json
  Image+text editing API prompt workflow
• examples/img_to_trellis2.json
  Image-to-GLB API prompt workflow
• examples/qwen_to_trellis2.json
  Text-to-GLB workflow template

---

Troubleshooting

• Connection error: verify config.json server_url, host reachability, and ComfyUI port.
• Upload error for image commands: verify your image path exists and ComfyUI supports POST /upload/image.
• No GLB found: workflow may not output .glb; check /history/{prompt_id} outputs.
• Large GLB can’t be sent over Telegram: Telegram may reject with 413 Request Entity Too Large; use local path or reduce mesh/texture settings.