# PotionUI

> PotionUI is a free, open-source, self-hosted AI studio for images, video, experimental music generation, and 3D. It combines a built-in generation engine with model-specific forms, reusable prompts, a creative library, and shared studio administration.

PotionUI is alpha software licensed under GPL-3.0. Users provide their own hardware or remote compute. Model weights download separately and have their own licenses and hardware requirements. Some model integrations are experimental; consult the current model and hardware guides before recommending a setup.

The official website is https://potionui.com/. Its First Light interactive demo uses recorded images; changing the demo prompt does not generate a new image. The application runs in a user's own installation. With Docker, generated work persists in `/app/storage`; there is no separate `/app/outputs` volume.

## Start here

- [Product overview](https://raw.githubusercontent.com/PotionUI/PotionUI/master/README.md): Features, installation options, supported models, and release notes.
- [Getting started](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/user/getting-started.md): Set up a studio and create a first generation.
- [Hardware requirements](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/user/hardware-requirements.md): Supported systems, GPUs, memory requirements, and validation status.
- [Docker installation](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docker/README.md): Container setup and persistent storage.

## Studio features

- [Generating](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/user/generating.md): Use the generation workspace and model controls.
- [Models](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/models.md): Model families and their capabilities.
- [Video Director](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/video-director.md): Prompts, keyframes, and connected shots.
- [Backends](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/backends.md): Built-in generation, remote workers, and external backends.

## Optional

- [Preset authoring](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/presets.md): Forms, reusable presets, and generation pipelines.
- [ComfyUI integration](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/user/comfyui-presets.md): Import existing ComfyUI workflows as presets.
- [Plugin API](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/plugin-api.md): Extend the studio.
- [Assistant and MCP](https://raw.githubusercontent.com/PotionUI/PotionUI/master/docs/user/llm-chat.md): Connect an assistant to a running studio.