Packages
A uv workspace of five packages declared in the root pyproject.toml, with no bundled or checked-in frontend.
Workspace
| Package dir | Import name | Role | Depends on audio-core |
|---|---|---|---|
| audio-core | audio_core | Shared audio I/O, conversion, feature extraction, DSP primitives | — |
| dj-engine | mixbox | Primary CLI + NiceGUI review app | yes |
| analyzer | hitscan | Independent MIR, source separation, reporting | yes |
| video-gen | hitvid | Audio-reactive video generation | yes |
| emotion | valaro | Valence-arousal analysis via Essentia MusiCNN | no (standalone) |
Entry Points
| Entry | Command |
|---|---|
Main subcommands: mix, plan, gui, config (plus analyze/plugins placeholders) in mixbox.cli.commands | uv run mixbox mix track1.wav track2.wav --output-dir out/ |
GUI — global --config-file precedes the subcommand | uv run mixbox --config-file config.yaml gui --host 127.0.0.1 --port <free-port> --no-browser |
Review server module — needs a real --dist-dir, its checked-in default points outside this repository tree | uv run python -m mixbox.review_server --dist-dir <existing-built-ui> --host 127.0.0.1 --port <free-port> |
Asset-gated
The
user/andtunes/trees are absent, so rotation and afro work cannot be verified without local media.