# 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.