Install#
Maystro is installed and updated by the Maystro Launcher, a small desktop application. You receive the installer link and your license key by e-mail after your access request is confirmed.
- Download and run
Maystro-Setup-latest.exefrom the link in your e-mail. The installer is not code-signed yet, so the first time you run it Windows SmartScreen shows Windows protected your PC. Click More info, then Run anyway. - Open the launcher and choose Install. The install flow has seven steps:
| Step | What you decide |
|---|---|
| Location | The folder Maystro is installed into. Everything the app writes (settings, outputs, logs, the runtime environments) lives under this folder. Pick an SSD with at least 100 GB free; see Requirements. |
| Activation | Paste your license key (MAY-XXXX-XXXX). The launcher activates it against the Maystro server and stores the activation token locally. See Activate your license. |
| Version | The Maystro version to install. The list comes from the private package index your license unlocks; the newest version is preselected. |
| Configure | GPU selection. Pick the NVIDIA card Maystro should use. |
| Database | PostgreSQL host, port, database, user and password. Click Test Connection before you continue; see Requirements. |
| Review | A summary of your choices. Repair mode reinstalls Python and recreates the environment; leave it off for a fresh install. |
| Install | The launcher creates two managed Python environments: one for Maystro and one for the Vireo runtime, the engine that renders video and trains character LoRAs. It also downloads the assistant's LLM engine, a pinned llama.cpp build with its CUDA runtime (about 0.6 GB). |
- When the install finishes, click Launch. The launcher starts the backend and the Vireo runtime, then opens the Maystro workspace in its own window. External links open in your default browser.
Updates
The launcher checks the package index for new Maystro versions and offers them on the launch screen. The launcher itself checks for a newer build on start and asks before downloading it. The last version you installed keeps working even if you stop renewing.
If the install fails#
- Retry with Repair mode enabled on the Review step.
- Open the dev console from the bottom-left button of the launcher, run
uv cache clean, and retry. - Try a different install location.
- Still stuck: write to support@maystro.ai with the launcher log.