PotionUI
The self-hosted generation studio you can hand to other people.
Images, video and music on your own GPU · Free and open source · Linux & Windows
Install · Quick start · Website · Docs · Changelog · Contributing · Security
Run Krea-2, Anima, SDXL, Flux, Wan, LTX, Qwen-Image, MiniMax and YuE2 on one box — then give your team, your household, or your agents their own logins, presets, and limits. No node graphs. No per-model setup. Pick a model, type, watch it render live.
https://github.com/user-attachments/assets/950415f7-da97-403e-811b-4c9c41d8106f
Why PotionUI:
- Forms, not wiring — each model exposes only the controls it actually
understands.
- Accounts, groups, admin panel — one GPU, many users, per-user presets
and model access.
- Drive it from Claude Desktop or any MCP client — per-user tokens; every
write action needs your approval.
- Video Director — compose shots in sections instead of one giant prompt.
Beta 0.2.0 · Linux and Windows x86_64 + NVIDIA · WSL2 or
Docker ·
Discord · Reddit ·
Ko-fi
60 seconds to first image
PotionUI is a self-hosted app for generating images, video and music with your own GPU, built to be shared: every person gets their own login, presets and limits. Pick a model, type, and watch it render live.
git clone https://github.com/PotionUI/PotionUI.git potionui && cd potionui
./potionui doctor # check prerequisites, with a repair command for anything missing
./potionui start # create the venv, install deps, launch backend + frontend, print the URL
Native Windows: .\potionui.cmd doctor and .\potionui.cmd start from PowerShell or cmd.
Floor: 8 GB VRAM + 16 GB RAM (SDXL). More in Install.
What you can do
Models
No model weights ship with PotionUI. Models download at your request, each under its own license. See Models and licensing.
Install
PotionUI runs on Linux and Windows x86_64 with an NVIDIA GPU.
| Way in | How |
|---|
| Linux | ./potionui doctor, then ./potionui start |
| Windows | .\potionui.cmd doctor, then .\potionui.cmd start from PowerShell or cmd |
| Docker | docker run --gpus all -p 26730:26730 ghcr.io/potionui/potionui:latest (details) |
| Pinokio | Add the launcher to Pinokio from its address, https://github.com/PotionUI/potionui-pinokio, then press Install and Start |
| Requirement | Needed |
|---|
| GPU | NVIDIA, Turing or newer, driver 580 or newer |
| Memory | 8 GB VRAM + 16 GB RAM to run SDXL; larger families need more (hardware requirements) |
| Python | 3.12 |
| Node.js | 22 or newer (24 LTS recommended) |
[!NOTE]
PotionUI is in beta: expect rough edges between releases, and back up anything you care about.
No GPU here? ./potionui start --profile remote dispatches to a worker. Profiles, Windows prerequisites, WSL2, running the backend and frontend separately and logs are in the install guide.
Documentation
Changelog
See CHANGELOG.md, or the GitHub releases page.
Contributing
- CONTRIBUTING.md: dev setup, test and lint commands, PR expectations.
CLAUDE.md: the architecture reference; package-layering rules are enforced by tests/architecture/test_layering.py.- Security issue? See SECURITY.md.
Support
If PotionUI is useful to you, a Ko-fi contribution helps keep it going. Development happens in the open on Discord; news, showcases and questions also go to r/PotionUI.
License
PotionUI is GPL-3.0: see LICENSE. Third-party code is bundled under vendor/, each component keeping its own upstream license; full attribution in vendor/NOTICE.md.
Docs ·
Discord ·
Contributing
