Local Development

MixBox ships a primary mixbox CLI plus a NiceGUI-based web application (mixbox.gui), launchable through the CLI or directly as a module. Run everything from the repository root through uv.

Commands

Task	Command
Help	uv run mixbox --help
Show resolved config	uv run mixbox config
Run a mix	uv run mixbox mix <input_paths>
GUI via CLI	uv run mixbox --config-file config.yaml gui --host 127.0.0.1 --port <free-port> --no-browser
GUI via module	uv run python -m mixbox.gui --host 127.0.0.1 --port 55533 --debug --no-browser

Flag order

The global --config-file MUST precede the subcommand (gui, mix), otherwise the CLI falls back to built-in defaults and MIXBOX_ environment variables.

Ports

Launch path	Default port
python -m mixbox.gui	55533
config.yaml value	8080

Pick free ports

Pass explicit free ports for local runs instead of copying deployment defaults.

Missing assets

A fresh clone has no user/ or tunes/ audio assets, so never point local commands at those paths.