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

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:

/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:

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:

docker compose down

Do not remove ACE-Step or change the dashboard/profile controller until the A/B test has been accepted.