Release 1.1.0. Everything here came out of using the style picker and finding
the same shape of problem in several places: the connector showed the REST
API's own words to someone who cannot act on them, or showed nothing at all.
Errors, in one place. `friendly_error`/`short_error` (styleref_api.py) rewrite
an API failure as something a node graph can act on — the Login node's Sign in
button, the Search styles… dialog, generate-it-once for a 409 — and Load and
Apply re-raise through them. The raw 401 told users to send an
`Authorization: Bearer` header into ComfyUI's red error window, which has no
buttons at all. `short_error` is the same failure at widget width; the
"loaded style" line used to render the whole paragraph uncut, because the
length guard sat on the success branch only.
The picker:
- Sign in moved to the title row. It changes what the whole dialog can show,
so it is not a property of one list.
- "My styles" hides itself when empty, and its rows now carry the thumbnail,
category and tags a gallery row carries — with visibility (Private /
Link-shared / Public) where a gallery row carries its author. A name on a
blank square sat directly above real cards.
- The gallery lane drops styles you own, so a published style of yours appears
once rather than in both lanes.
- No matches now offers /styles/create instead of a dead end.
- ↓/↑ walk the rows, Enter takes the top hit, Esc closes; query, category and
sort survive between opens.
Load hides `search`/`category` when the dialog is available — they are the
headless fallback, and next to a working button they are the same duplication
the Login node's `action` dropdown was removed for. Picking also clears the
query, which otherwise made every later execution run a search it did not need.
Apply gains a Copy prompt button. Four of its six targets exist to be copied
out of ComfyUI, and the only way to read one in full was to wire up a Preview
Any node. The warning badge now matches any text encoder, not the exact class
`CLIPTextEncode` — SDXL, SD3 and Flux ship their own, so it did nothing on most
real graphs.
Reference Images no longer fails the queue when a style has no inspiration
images: it feeds IPAdapter or a preview, never the sampler, so it reports and
returns an empty batch. `max_images: 0` mutes it without rewiring.
Needs the matching StyleRef-Webapp deploy: the library lane's category, tags
and heroImage come from /api/v1/me/styles, and its search now scores the same
fields the gallery search scores.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The style browser surfaced the REST 401 verbatim, which told people to send
an `Authorization: Bearer` header and pointed at styleref.io/mcp — neither of
which anyone can act on from inside ComfyUI.
- A signed-out lane now renders one actionable row: a Sign in button running
the same browser OAuth flow as the Login node, plus a link to the setup
guide. Headless boxes still get the full instructions in the overlay, since
they cannot just click.
- /styleref/saved and /styleref/my-styles map an API 401 to `signedIn: false`
rather than echoing the message. Expired or revoked stored credentials are
the signed-out state, so the dialog should offer sign-in, not an error.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The root templates ran on SDXL base, where every gallery style washed out. A
full compiled style is ~480 tokens and SDXL's CLIP attends to ~77 per chunk, so
the style was truncated before the sampler saw it. No checkpoint swap fixes
that, Juggernaut included: it is an SDXL finetune with the same encoder.
Root set now runs FLUX.1 dev (Comfy-Org fp8 all-in-one, since BFL's own file is
UNET-only and CheckpointLoaderSimple cannot load it), compiled from the flux
target, whose T5 encoder takes the whole prompt. FluxGuidance 3.5, CFG 1.0, and
ConditioningZeroOut on the negative input: FLUX is guidance distilled and has no
negative channel, exactly like Z-Image. Uses EmptySD3LatentImage because FLUX
works in a 16-channel latent space.
The two sets load different gallery styles on purpose. How well a style demos is
a property of the style and the model together: Z-Image reproduces painterly
technique and keeps the Renaissance style, FLUX is strongest at light and
tonality and takes a noir one.
Also:
- Adds the reference-images template the root set was missing, and renumbers
Facets to 05, so both sets are 01-05 with matching names. Both sets are now
pinned by test against a shared story list.
- Model download metadata moves to each node's properties.models, where ComfyUI
reads it, so a missing checkpoint offers a download instead of being silently
substituted.
- The Load node names the style its slug resolves to, on a read-only row under
style_ref, via a new /styleref/resolve route.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The pack cited internal planning-doc items (plan P3-7, decision D1, plan
risk 9.2) that aren't public, leaving outside contributors with pointers
they can't follow. Each comment already states its reason; only the
dangling citation is removed.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Load, Apply, Facets, Reference Images, and Login nodes for loading StyleRef
creative styles into ComfyUI graphs. Zero runtime dependencies.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
