ChevalGrand520/local-gpu-imagegen

English | 简体中文
An MCP-first control plane with cryptographic model identity, explicit approvals,
and durable run evidence for the ComfyUI setup you already use.
Run a supported ComfyUI workflow from Codex without modifying your setup.
Setup stores a resolved, version-pinned launcher equivalent to
uvx --from local-gpu-imagegen==0.9.1 local-gpu-imagegen serve; it does not
depend on a console script from the temporary uvx environment. If an older
entry reports client_setup_drift, remove only that client entry and apply
setup again. Starting ComfyUI does not repair an MCP launcher failure; backend
readiness is checked after the client loads the server.
Ask Codex:
This path requires Python 3.11 or 3.12, Codex, an already-running local ComfyUI
instance, an already-installed model, and one ordinary txt2img API workflow
using the supported built-in topology. It uses your existing local image
backend and model with no silent model downloads or switches. It does not
install a backend, download a model, convert UI-format JSON, or execute a
workflow that requires unsupported custom nodes. An explicit Windows portable
managed-start option is documented below.
The v0.9 supported host scope is Windows 10/11 x64 with NVIDIA. The single
py3-none-any wheel describes pure-Python packaging, not a separate Linux
edition or a claim of Linux managed-generation support. Ubuntu CI verifies the
platform-neutral MCP, packaging, existing-backend, and unsupported-platform
contracts; Windows runs the complete portable-bootstrap suite.
ComfyUI generates the pixels. Local GPU Imagegen controls authority,
reproducibility, review, and recovery around that generation.
Five-minute Quickstart | Launch playbook | Alternatives
Bring Your Own ComfyUI Workflow
The retained Codex workflow-onboarding session inspected and registered a
supported graph, then bound its exact model components; it did not submit a
prompt or use the GPU. Historical generated-image records remain available
for technical audit, but v0.9 does not use them as promotional visuals or as
evidence of image-quality superiority.
This path requires an existing local image backend and model; there are no silent model downloads or switches.
Guided Bootstrap (Windows NVIDIA)
For an existing environment, run bootstrap status and reuse only a verified
portable root, checkpoint, and loopback endpoint. For a zero-environment setup,
bootstrap plan shows the exact portable archive, checkpoint, byte ceiling,
license URLs, SHA-256 hashes, disk/VRAM requirements, and bounded rollback;
bootstrap apply requires the displayed explicit confirmation. Downloads are
resumable and never silent. The frozen scope is Windows 10/11 x64 with NVIDIA
RTX 20-series or newer, 10 GiB VRAM, and 30 GiB free disk. Docker is not
required. This model-free
bootstrap contract does not prove image generation or production readiness.
setup is read-only without --apply. The apply path delegates to the client's official mcp add command; Local GPU Imagegen does not edit client configuration files directly or download a model.
**Trust proof:** the retained ordinary-route result came from one installed Codex session. Discovery did not load weights; trust and route identity were explicit; successful rounds were bounded; review used the original-resolution PNG; finalization was bound to the reviewed bytes; and the run state remains recoverable. The evidence proves this one result, not complete 9+3 acceptance, measured performance, or production readiness.
**v0.9 local acceptance:** a fresh Windows/NVIDIA installation built from the
user-approved ComfyUI archive and SDXL checkpoint reached managed readiness,
served exactly seventeen MCP tools, and finalized one reviewed non-human
environment image with byte-identical source and final hashes. The artifact
remains local until a separate sanitized export and is not bundled in the
package. Two separate character attempts failed strict hand, eye, or tail
review; prominent-human anatomy quality is therefore not established.
Optional Managed ComfyUI Startup
Windows setup can register one existing portable root for managed startup:
The opt-in command validates the fixed portable layout and registers
python_embeded\python.exe -s ComfyUI\main.py at 127.0.0.1:8188. It does not
install ComfyUI or download a model. An already-running endpoint is reused but
never owned or stopped. A child started by the MCP process is stopped at MCP
exit only when its queue is empty; a non-empty queue is retained and reported.