BehzadandClaude Sonnet 5
dfc6221c47
The Renaissance style carries no guardrails, so it compiles an empty negative, and Z-Image has no negative channel to put one in either. A style steeped in classical painting therefore drifts to classical nudes on a neutral subject — which is a poor look for a first-run demo and for the screenshots people take of it. Positive phrasing in the subject is the only lever either model leaves, so two of the three subjects now say so outright. The grid also reads better: a dusk exterior, an interior, and an object with no figure at all is a wider spread than three peopled scenes, and it makes the "one style, unrelated subjects" claim harder to argue with. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
179 lines
8.0 KiB
Markdown
179 lines
8.0 KiB
Markdown
# StyleRef nodes for ComfyUI
|
|
|
|
<img src="https://raw.githubusercontent.com/StyleRef/styleref-comfyui/main/assets/workflow.webp" alt="One StyleRef style applied to seven different subjects" width="420" align="right">
|
|
|
|
Define a creative style once on [StyleRef](https://styleref.io) — colors,
|
|
lighting, mood, composition, guardrails — then load it as a node and reuse it
|
|
across your workflows.
|
|
|
|
Every frame on the right is the same style, a different subject.
|
|
|
|
The style is compiled server-side for whichever model you point it at, so the
|
|
same style produces prompt text phrased appropriately for each one.
|
|
|
|
**No account needed** to load and apply public gallery styles. An account adds
|
|
your own private styles. **Nothing in this node pack spends credits.**
|
|
|
|
---
|
|
|
|
## Install
|
|
|
|
**ComfyUI Manager** (recommended) — search for **StyleRef** and click Install.
|
|
|
|
**Manually:**
|
|
|
|
```bash
|
|
cd ComfyUI/custom_nodes
|
|
git clone https://github.com/StyleRef/styleref-comfyui
|
|
```
|
|
|
|
Restart ComfyUI. No dependencies to install — the pack uses only the Python
|
|
standard library. Look for `[StyleRef] v1.0.4 — 5 nodes registered` in the
|
|
server console at startup.
|
|
|
|
## 60-second quickstart
|
|
|
|
1. Add **StyleRef Load** and paste a slug from the
|
|
[gallery](https://styleref.io/gallery) into `style_ref` (try
|
|
`72e1zdae-e2d54a18d090`, the Noir Low-Key Portrait style) — or click
|
|
**Search styles…** to pick one.
|
|
2. Add **StyleRef Apply**, connect `style`, type a subject, pick your target.
|
|
3. Wire `positive` / `negative` into your CLIP Text Encode nodes.
|
|
|
|
Or drag [`workflows/01-quickstart.json`](workflows/01-quickstart.json) onto the
|
|
canvas.
|
|
|
|
## Nodes
|
|
|
|
| Node | Sign-in | What it does |
|
|
| --- | --- | --- |
|
|
| **StyleRef Load** | No | Fetch a style by share slug or share URL — and, signed in, your own private styles by id or `/styles/{id}` URL. Names the loaded style on the node, plus gallery search with a picker dialog and a ↻ Refresh button. |
|
|
| **StyleRef Apply** | No | Compose a subject with a style into `positive` / `negative` prompts for a chosen target, with a prompt preview in the node body. |
|
|
| **StyleRef Facets** | No | Every schema section as its own output — exactly the style board's section list, plus the six custom style items. |
|
|
| **StyleRef Reference Images** | No | The style's inspiration images as an IMAGE batch — for IPAdapter and reference conditioning. |
|
|
| **StyleRef Login** | — | Status line + Sign in / Sign out buttons. Needed only to load your own private styles. |
|
|
|
|
### Targets
|
|
|
|
`ai_tools`, `style_md`, `flux`, `midjourney`, `diffusion`, `json` — exactly the
|
|
web app's copy-box format list. For the sampler in your graph use `flux` (FLUX
|
|
models) or `diffusion` (SDXL, SD1.5, DALL·E-class); the other four are for
|
|
copying the output out of ComfyUI, and the node warns if one feeds a CLIP
|
|
encoder.
|
|
|
|
### Browse the gallery
|
|
|
|
[](https://styleref.io/gallery)
|
|
|
|
Every style on [styleref.io/gallery](https://styleref.io/gallery) loads here by
|
|
its slug — no account needed.
|
|
|
|
### Making your own styles
|
|
|
|
Extraction (turning an image into a style) happens on
|
|
[styleref.io](https://styleref.io) — upload an image there, refine the result,
|
|
and it lands in your library. Load it here by its share slug or id
|
|
(sign in with the Login node first).
|
|
|
|
## Workflow templates
|
|
|
|
The templates at the root run on **FLUX.1 dev** (the Comfy-Org fp8 all-in-one
|
|
checkpoint, downloaded on first queue). FLUX reads the prompt with T5, so a
|
|
full compiled style fits — an SDXL CLIP encoder truncates it at ~77 tokens,
|
|
which is why the style washes out there no matter which checkpoint you use.
|
|
|
|
| File | Sign-in | Story |
|
|
| --- | --- | --- |
|
|
| [`01-quickstart.json`](workflows/01-quickstart.json) | No | Load → Apply → generate |
|
|
| [`02-consistency-grid.json`](workflows/02-consistency-grid.json) | No | One style, three subjects, side by side |
|
|
| [`03-your-own-style.json`](workflows/03-your-own-style.json) | Yes | Extract on the web, load your own style here |
|
|
| [`04-reference-images.json`](workflows/04-reference-images.json) | No | The style's inspiration images as a batch, next to a render |
|
|
| [`05-facets.json`](workflows/05-facets.json) | No | Every section of the style as its own output, next to a normal render |
|
|
|
|
A parallel set wired for **Z-Image Turbo** (an S3-DiT model — UNET + Qwen text
|
|
encoder + VAE, compiled from the `diffusion` target) lives in
|
|
[`workflows/z-image/`](workflows/z-image): the same five stories on that
|
|
loader stack. The three model files download on first run.
|
|
|
|
The two sets load **different gallery styles on purpose.** How well a style
|
|
demos is a property of the style *and* the model. FLUX is strongest at light
|
|
and tonality, so its templates load a noir style — hard key, crushed blacks,
|
|
monochrome. Z-Image reproduces painterly technique faithfully, so its
|
|
templates load a Renaissance tempera style. Swap either for any slug from the
|
|
[gallery](https://styleref.io/gallery); these are starting points, not
|
|
limits.
|
|
|
|
**Neither FLUX nor Z-Image takes a negative prompt.** Both are guidance
|
|
distilled and run at CFG 1.0, where the negative branch is multiplied out
|
|
entirely — so neither set carries a negative encoder, and the sampler's
|
|
negative input gets a zeroed conditioning. StyleRef still compiles
|
|
the negative and previews it on the canvas; fold anything you need from it into
|
|
`subject` on Apply as a positive phrase. Raising CFG does not bring it back.
|
|
|
|
## Signing in
|
|
|
|
Add the **StyleRef Login** node and click **Sign in (browser)** — no queueing
|
|
needed. Your browser opens, you approve, and the node's status flips to signed
|
|
in. The token is stored at `~/.config/styleref/credentials.json` with `0600`
|
|
permissions. The [`styleref` CLI](https://www.npmjs.com/package/styleref)
|
|
shares this login.
|
|
|
|
(No frontend at all? `npx styleref login` signs in the same credentials file,
|
|
and queueing the Login node reports the current status.)
|
|
|
|
### Running ComfyUI on a remote or headless machine
|
|
|
|
Browser sign-in **cannot** work on a rented GPU box, RunPod, or any headless
|
|
server: there is no browser to open, and `localhost` is the wrong machine. Use a
|
|
token instead:
|
|
|
|
1. Copy a token from your [account page](https://styleref.io/account).
|
|
2. Where ComfyUI runs, set `STYLEREF_TOKEN=<token>`
|
|
3. Restart ComfyUI.
|
|
|
|
`STYLEREF_TOKEN` always takes precedence over stored credentials. The Login node
|
|
detects the headless case and prints these instructions rather than hanging.
|
|
|
|
## Credits
|
|
|
|
**Nothing in this node pack spends credits.** Loading, searching, and applying
|
|
styles is free and unlimited within the public rate limit. Extraction — the one
|
|
paid action — happens on [styleref.io](https://styleref.io), where you can
|
|
preview and refine the result before it costs anything beyond the extraction
|
|
itself. See [plans and limits](https://docs.styleref.io/using-styleref/plans-and-limits).
|
|
|
|
## Configuration
|
|
|
|
| Variable | Purpose |
|
|
| --- | --- |
|
|
| `STYLEREF_TOKEN` | Bearer token; overrides stored credentials. The headless path. |
|
|
| `STYLEREF_API` | API base URL. Defaults to `https://styleref.io/api/v1`. |
|
|
| `STYLEREF_FORCE_BROWSER_LOGIN` | `1` forces browser login, `0` forces the token path. |
|
|
|
|
## Development
|
|
|
|
```bash
|
|
pip install pytest ruff pillow numpy # pillow/numpy are test-only deps
|
|
pytest tests/ -q
|
|
ruff check .
|
|
python scripts/build_workflows.py # regenerate workflow templates
|
|
```
|
|
|
|
The workflow templates are generated — edit
|
|
[`scripts/build_workflows.py`](scripts/build_workflows.py), not the JSON.
|
|
|
|
The nodes are a thin client over StyleRef's public
|
|
[REST API v1](https://docs.styleref.io/for-ai-agents/rest-api/overview-and-authentication)
|
|
([OpenAPI](https://styleref.io/api/v1/openapi.json)). All prompt compilation
|
|
happens server-side — this pack never writes style prose itself, so improvements
|
|
to StyleRef's compiler reach you without an update to this pack.
|
|
|
|
## Docs & support
|
|
|
|
- [ComfyUI connector docs](https://docs.styleref.io/connectors/comfyui/install-and-quickstart)
|
|
- [Issues](https://github.com/StyleRef/styleref-comfyui/issues)
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE).
|