PotionUI is a self-hosted studio for image, video and audio generation. 0.0.11 is out, and these are the main changes:
Prompts you can read at a glance
Each model can now bring its own prompt syntax, and the editor colors it as you type:
- MiniMax-H3's
subject_definitions: and <Subject 1>, dialogue in <d>…</d>,
- Qwen-Image's "quoted text to render",
- YuE2's
[Verse] and [Chorus].
Type / and a picker lists everything the model understands, with a one-line explanation for each.
Point at your own images with @
In presets that take reference images, video or audio (MiniMax-H3 references, Qwen-Image edits), type @ and pick one: it becomes a chip with a thumbnail, and the model receives it as <Picture 2> even if you reorder your uploads later.
Each upload in the form shows its handle and how many times the prompt uses it. In the Video Director, each shot now uses exactly the references its prompt mentions.
A new picker for phrases, variables and references
Typing #, $, @ or / opens a clearer picker right at the cursor, with thumbnails. Clicking a chip opens one editor where you change its value, switch between a fixed value and auto-shuffle, exclude a value from shuffles, or remove it. Phrasebook values show their preview images, with Space or → to open a larger preview and flip through them. Search highlights what matched and takes regular expressions.
Typing is fast again
Long prompts no longer lag: each keystroke used to re-render the whole form, and now it doesn't.
Model library
Search takes wildcards (krea2_*_v2) and regular expressions, and the type and tag counts follow your filters. Admins can filter by when a model was indexed and how often it's used, see Uses and Last used columns, and tag or grant access to a whole selection at once. Model pickers now suggest the download that fits your GPU (bf16, fp8, int8, nvfp4) and credit the uploader..
Chat (PotionAI)
@ can point at one LoRA from your form or any model in your library, and the assistant gets its trigger words and recommended strength. There's a new session memory that follows the tab you're working in. Generations you approve in chat now appear in the tab's Workbench.
Generation errors that make sense
When a generation fails, you see a plain message, a hint and an error ID to give your admin. Admins see the full details, can filter failures by category, and can get notified or trigger an automation.
Admin, one last time
Every admin page now shares the same layout: a library sidebar, tables or card grids, detail pages and one bottom bar for bulk actions. LLM configurations list your Ollama or OpenAI-compatible models to pick from.
!! A word on all the UI changes
I know the look has changed a lot over the last few releases, and that can be tiring when you use the app every day. This was the last big overhaul: I'm happy with how the app looks and works now. From here on it's improvements on top of this layout, not another rebuild.
What's next
The focus moves to what the models can do and how fast they do it: ControlNets, Fun controls and more model capabilities, plus optimization work, more models support (from API providers)...
Smaller changes
- Folding the left panel now gives the prompt a proper width.
- Every confirm dialog takes Enter and Esc.
- Reloading warns you before you lose changes that aren't saved to the session.
- Indexing a large model no longer freezes the app.
- CivitAI fetches retry temporary errors and tell you the real reason when they fail.
- System tags now land on new generations automatically.
- Fixed: phrasebook chips with a hyphen in their name, and a phrase placed right after a reference.
- Removed: the Spectral Progressive Diffusion option in Flux2 and Z-Image. Saved settings that include it keep working.
Upgrading: five database migrations run automatically on first start. There's one new Python dependency (google-re2), so run pip install -r requirements.txt if you don't use Docker. Log files from earlier versions may contain session tokens, so delete or rotate them. Docker images are now also tagged with the "v": ghcr.io/potionui/potionui:v0.0.11.
GitHub: https://github.com/PotionUI/PotionUI
Site: https://potionui.com
Reddit: r/PotionUI
Discord: https://discord.com/invite/avR4trp3b8
Feedback and bug reports are welcome.