Bump Assistent to 0.5: denser Krea packs, slash commands, and chips.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -1,12 +1,15 @@
|
||||
# Swarm Assistent
|
||||
|
||||
SwarmUI extension for **collaborative Krea 2** prompting via **Ollama**: chat + multi-window board (live Generate + refs), LoRA/trigger awareness, applyable patches, **img2img / inpaint**, auto Generate, and Civitai search with Confirm.
|
||||
SwarmUI extension for **collaborative Krea 2** prompting via **Ollama**: chat + multi-window board (live Generate + refs), LoRA/trigger awareness, applyable patches, **img2img / inpaint**, slash commands, aspect/seed chips, auto Generate, and Civitai search with Confirm.
|
||||
|
||||
**Version 0.5.0** — denser Krea 2 knowledge in prompt packs, new patch fields, `/help` slash commands, composer chips.
|
||||
|
||||
## Layout
|
||||
|
||||
- **Left — Board:** live **Generate** window + **Ref** windows (drop / paste / *Send to Assistent* / Snapshot gen). Per-window **vision** checkbox attaches that image to the next chat.
|
||||
- **Splitter:** drag to resize panes
|
||||
- **Right (wider):** chat — first visit shows a short how-to. Only the **latest** JSON proposal keeps action buttons; Apply + Generate spins/disables while a generation is running.
|
||||
- **Chips** above the composer: aspect ratios, Seed lock / random, Vary.
|
||||
- **Top-right:** prompt pack + settings (Ollama URL, model, auto-apply / auto-generate)
|
||||
|
||||
## UX
|
||||
@@ -20,6 +23,22 @@ SwarmUI extension for **collaborative Krea 2** prompting via **Ollama**: chat +
|
||||
- Pure Q&A without a patch does **not** start Generate
|
||||
- **Interrupt** stops Swarm generation / clears busy state
|
||||
- **Civitai** search cards require **Confirm download** (uses Swarm `DoModelDownloadWS` + stored `civitai_api` key). Auto-download is off by default.
|
||||
- Pack auto-selects from the user message (critique / inpaint / params / compose / describe / write) unless you changed the dropdown yourself.
|
||||
|
||||
### Slash commands (client-side, no LLM)
|
||||
|
||||
| Command | Effect |
|
||||
| --- | --- |
|
||||
| `/help` | List commands |
|
||||
| `/gen` | Generate now |
|
||||
| `/look generate\|refN` | Attach that board window + ask the LLM to look |
|
||||
| `/init` `/mask` `/clear` | Same as board buttons |
|
||||
| `/interrupt` | Stop generation |
|
||||
| `/aspect 16:9` | Set size from the official 1K table |
|
||||
| `/seed lock\|random` | Lock or randomize seed |
|
||||
| `/vary` | New seed, same prompt (+ generate if auto) |
|
||||
| `/pack write\|critique\|compose\|params\|inpaint\|describe` | Switch pack |
|
||||
| `/civitai <query>` | Ask LLM to search Civitai (Confirm still required) |
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -47,33 +66,48 @@ Restart / rebuild SwarmUI after clone.
|
||||
| Pack | Role |
|
||||
| --- | --- |
|
||||
| `base_krea2` | Always injected: Krea 2 rules + JSON patch / actions contract |
|
||||
| `write_prompt` | Craft / improve prompts |
|
||||
| `write_prompt` | Craft / improve prompts (prose structure) |
|
||||
| `critique_image` | Vision critique → fixes |
|
||||
| `compose_scene` | Scene / moodboard |
|
||||
| `fix_params` | Width/height/steps/CFG/seed/σ-shift |
|
||||
| `compose_scene` | Scene / moodboard via board refs → text |
|
||||
| `fix_params` | Aspect / steps / CFG / seed / batch |
|
||||
| `inpaint_edit` | Init Image img2img + Mask inpaint |
|
||||
| `describe_ref` | Vision → Krea prompt (no generate by default) |
|
||||
|
||||
Live context (checkpoint, server inventory LoRAs + triggers, wildcards, current params) is injected every request.
|
||||
|
||||
**Cloud-only Krea.ai features** (moodboards UI, Generative Sliders, Creativity Raw/Low/Medium/High) are **not** in Swarm. The assistant emulates them with prompt language + board refs. Optional patch fields `creativity` / `intensity` / `complexity` / `movement` guide the LLM only.
|
||||
|
||||
### Patch actions
|
||||
|
||||
```json
|
||||
{
|
||||
"prompt": "...",
|
||||
"loras": [{"name": "exact", "weight": 0.8, "triggers": ["..."]}],
|
||||
"width": 1024, "height": 1280, "steps": 8, "cfg": 1,
|
||||
"seed": -1, "sigma_shift": 1.15,
|
||||
"aspect": "16:9",
|
||||
"width": 1376, "height": 768,
|
||||
"steps": 8, "cfg": 1,
|
||||
"seed": -1, "images": 1,
|
||||
"sigma_shift": 1.15,
|
||||
"creativity": "medium",
|
||||
"intensity": 0, "complexity": 0, "movement": 0,
|
||||
"vary": false, "lock_seed": false,
|
||||
"use_init_image": true,
|
||||
"init_creativity": 0.45,
|
||||
"use_mask_image": false,
|
||||
"clear_prompt_images": false,
|
||||
"look_at": ["generate"],
|
||||
"slot_to_init": "generate",
|
||||
"snapshot_generate": false,
|
||||
"pack": "critique_image",
|
||||
"actions": ["generate"],
|
||||
"search_query": null
|
||||
}
|
||||
```
|
||||
|
||||
- `aspect` — maps to official 1K sizes (`1:1`, `4:5`, `2:3`, `16:9`, `9:16`, `4:3`, `3:2`, `2.35:1`)
|
||||
- `vary` / `lock_seed` / `images`|`batch` — seed and batch helpers
|
||||
- `clear_prompt_images` — strip `<image…>` embeds from the prompt box
|
||||
- `pack` — switch the active prompt pack for a follow-up
|
||||
- `generate` — auto-generate after apply (when enabled)
|
||||
- `look_at` — hop vision from named board windows (`generate`, `ref1`, …)
|
||||
- `slot_to_init` / `slot_to_mask` — copy that window into Swarm Init / Mask
|
||||
@@ -83,6 +117,8 @@ Live context (checkpoint, server inventory LoRAs + triggers, wildcards, current
|
||||
|
||||
Mask convention: **white = edit**, black = keep. Creativity ≈ denoise (0–1).
|
||||
|
||||
Turbo defaults: steps **8**, CFG **1** (never 0), sigma shift **1.15**.
|
||||
|
||||
## API routes
|
||||
|
||||
| Route | Role |
|
||||
|
||||
Reference in New Issue
Block a user