Skip to content

Quickstart

Already installed QuOptuna? This five-minute path gets you from a cold start to your first best model using a built-in UCI dataset. If you haven’t installed yet, see Installation.

Terminal window
uvx quoptuna

A gradient ASCII banner prints, and your browser opens to the wizard at http://localhost:8000.

On Step 1 — Dataset, choose a built-in UCI dataset (for example, Iris, id 53) instead of uploading a CSV.

On Step 2 — Features, select your feature columns and the target column. The defaults from the dataset work fine for a first run.

On Step 3 — Configure, keep the default model (SVC), leave the sampler and pruner as-is, and set number of trials to a small value like 3 so it finishes quickly.

On Step 4 — Optimize, click run. Watch trials complete live. When it finishes, the best trial and its model are highlighted.