Files
AI-Profile-Router/experiments/heartmula-3b/README.md
T

53 lines
1.5 KiB
Markdown

# HeartMuLa 3B quality test
Reversible A/B test of the public
`HeartMuLa/HeartMuLa-oss-3B-happy-new-year` model with
`HeartMuLa/HeartCodec-oss-20260123`.
The model and codec are deliberately split across Athena's GPUs:
- HeartMuLa BF16: RTX 5080 (`cuda:0` inside the container)
- HeartCodec FP32: RTX 3060 (`cuda:1` inside the container)
The public model does not yet support reference-audio conditioning. Pure
instrumental generation is exposed as an explicitly experimental option.
Generated files are lossless 48-kHz WAV files under `/data/music/heartmula`.
The container intentionally has no `com.mike-ai.music-worker` label while it
is being evaluated. This prevents it from conflicting with the production
profile controller's single ACE-Step worker.
## Checkpoints
The expected persistent layout on Athena is:
```text
/data/models/heartmula/ckpt/
├── HeartMuLa-oss-3B/
├── HeartCodec-oss/
├── gen_config.json
└── tokenizer.json
```
## Test operation
Only after the current music worker has been stopped:
```sh
cd /opt/mike-ai/heartmula-3b
docker compose up -d heartmula-test
docker compose logs -f heartmula-test
```
The temporary test UI listens locally on port `7863`. During the listening
test it is proxied through Athena's existing WireGuard gateway; permanent
dashboard/gateway integration is deliberately deferred until the audio has
been accepted. Stop it with:
```sh
docker compose down
```
Do not remove ACE-Step or change the dashboard/profile controller until the
A/B test has been accepted.