# Friend Beta Setup

Amadeus is a portable private beta. The archive intentionally does not contain
singer models or ONNX Runtime. On first launch, the setup wizard introduces
Amadeus, presents the private beta EULA, installs the CPU ONNX Runtime in its
own step, and lets you select one or more verified voice downloads. Voicebank
terms are accepted separately from the software EULA.

The wizard verifies archive size and SHA-256 before atomic installation. Managed
voice models and ONNX Runtime components are locked beside the executable under
`data/models/` and `data/runtimes/`; they are not scattered through the user's
home directory. `AMADEUS_PORTABLE_DIR` can choose a different portable root;
placing an empty `amadeus-portable.txt` beside the executable uses a `data/`
directory there.

Before leaving setup, Amadeus renders a tiny embedded score through all four
models using a disposable in-memory SQLite project. The timing, F0, mel, and
waveform artifacts are discarded; no `.amadeus` project or output file is
created.

Useful support commands:

```text
amadeus --version
amadeus --help
amadeus --diagnostics
amadeus --renderer=glow
amadeus --renderer=wgpu
```

wgpu defaults to bounded VSync for low-end discrete GPUs. To test Vulkan on
Windows or Linux, launch with `WGPU_BACKEND=vulkan amadeus --renderer=wgpu`.

The GUI starts the sibling `antimatter` engine from the extracted executable
directory. It does not depend on the process working directory.
