maolandaw/HeartMuLa-happy-new-year-burn

HeartMuLa-oss-3B-happy-new-year (Burn Format)

This repository contains Burn-format weights for the upstream model:

• HeartMuLa/HeartMuLa-oss-3B-happy-new-year

The published artifacts are packaged as Burn Pack (.bpk) archives. The repository also includes Rust tooling to regenerate the raw export manifest and Burn pack from the upstream checkpoint.

Repository Contents

Published model assets at the repository root:

• heartmula.bpk
• tokenizer.json
• gen_config.json
• config.json
• LICENSE

Conversion and packaging sources included in the repository:

• convert.sh: one-step export-and-pack script that writes heartmula.bpk at the repository root
• src/bin/export_heartmula_raw.rs: exports the upstream safetensors checkpoint into .npy tensors plus a manifest file
• src/main.rs: packs exported tensors into Burn Pack archives
• Cargo.toml, Cargo.lock: Rust dependencies for the packer
• UPLOAD_GUIDE.md: publishing notes for Hugging Face model hosting

Included Models

HeartMuLa generator

• Transformer-based audio generation model
• 28 backbone layers and 3 decoder layers
• Hidden size: 3072
• Intermediate size: 8192
• Audio vocabulary: 65,576 tokens

The checked-in manifest at heartmula/manifest.json contains 289 tensors.

File Sizes

Current repository payload:

• heartmula.bpk: 15,752,483,328 bytes
• tokenizer.json: 9,085,657 bytes
• gen_config.json: 101 bytes
• config.json: 1,537 bytes

Rebuilding the Artifacts

The repository includes the scripts needed to regenerate the Burn artifacts from the original upstream checkpoints.

Prerequisites

• A Rust toolchain capable of building the packer in this repository
• Local copies of the upstream checkpoints and support files arranged like this:

CKPT_ROOT/
├── HeartMuLa-oss-3B-happy-new-year/
├── LICENSE
├── tokenizer.json
└── gen_config.json

The exporter reads the Hugging Face safetensors shards directly from the checkpoint directory and copies tokenizer.json, gen_config.json, and LICENSE into the output artifact directory.

One-Step Conversion

./convert.sh CKPT_ROOT

This regenerates heartmula.bpk at the repository root and removes the temporary artifact directory when finished.

Download the Upstream Files

huggingface-cli download HeartMuLa/HeartMuLa-oss-3B-happy-new-year --local-dir CKPT_ROOT/HeartMuLa-oss-3B-happy-new-year
huggingface-cli download HeartMuLa/HeartMuLa-oss-3B-happy-new-year tokenizer.json --local-dir CKPT_ROOT
huggingface-cli download HeartMuLa/HeartMuLa-oss-3B-happy-new-year gen_config.json --local-dir CKPT_ROOT

Export Raw Tensors and Manifests

Example:

cargo run --release --bin export_heartmula_raw -- \
  --checkpoint-root CKPT_ROOT \
  --heartmula-subdir HeartMuLa-oss-3B-happy-new-year \
  --output-root artifacts/heartmula-happy-new-year-20260123

This produces directories such as:

• artifacts/heartmula-happy-new-year-20260123/heartmula_raw_f32/
• artifacts/heartmula-happy-new-year-20260123/tokenizer.json
• artifacts/heartmula-happy-new-year-20260123/gen_config.json
• artifacts/heartmula-happy-new-year-20260123/LICENSE

Each raw directory contains .npy tensor files and a manifest.json.

Pack Burn Archives

The Rust packer reads a manifest and writes a .bpk archive:

cargo run --release --bin heartmula-burn -- \
  --manifest artifacts/heartmula-happy-new-year-20260123/heartmula_raw_f32/manifest.json \
  --output artifacts/heartmula-happy-new-year-20260123/heartmula.bpk

Final Repository Layout

To reproduce the current published root layout, copy:

• artifacts/heartmula-happy-new-year-20260123/heartmula.bpk -> heartmula.bpk
• artifacts/heartmula-happy-new-year-20260123/heartmula_raw_f32/manifest.json -> heartmula/manifest.json
• artifacts/heartmula-happy-new-year-20260123/tokenizer.json -> tokenizer.json
• artifacts/heartmula-happy-new-year-20260123/gen_config.json -> gen_config.json
• artifacts/heartmula-happy-new-year-20260123/LICENSE -> LICENSE

Notes

• This repository is a model artifact and conversion repo, not a complete inference application.
• The checked-in manifests reference FP32 tensors.
• The repository includes the large Burn archives directly, so Git LFS configuration in .gitattributes is part of the expected publishable layout.
• config.json contains conversion metadata and architecture summary for the published package.

License

This conversion is distributed under Apache 2.0, matching the repository metadata and included license files.