maolandaw/HeartCodec-oss-20260123-burn

HeartCodec-oss-20260123 (Burn Format)

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

• HeartMuLa/HeartCodec-oss-20260123

The published artifact is packaged as a Burn Pack (.bpk) archive. The repository also includes Rust tooling to regenerate the raw export manifest and Burn pack from the upstream checkpoint.

Repository Contents

Published model asset at the repository root:

• heartcodec.bpk

Conversion and packaging sources included in the repository:

• convert.sh: one-step export-and-pack script that writes heartcodec.bpk at the repository root
• src/bin/export_heartcodec_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

Included Model

HeartCodec

• Flow-matching audio codec
• 8 RVQ levels
• Dual-stream transformer-style architecture

The current HeartCodec export manifest contains 818 tensors.

File Sizes

Current repository payload:

• heartcodec.bpk: 6,638,402,816 bytes

Rebuilding the Artifact

The repository includes the script needed to regenerate the Burn artifact from the original upstream checkpoint.

Prerequisites

• A Rust toolchain capable of building the packer in this repository
• A local copy of the upstream checkpoint arranged like this:

CKPT_ROOT/
└── HeartCodec-oss-20260123/

The exporter reads the Hugging Face safetensors shards directly from the checkpoint directory.

One-Step Conversion

./convert.sh CKPT_ROOT

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

Download the Upstream Files

huggingface-cli download HeartMuLa/HeartCodec-oss-20260123 --local-dir CKPT_ROOT/HeartCodec-oss-20260123

Export Raw Tensors and Manifest

If you want to run the steps manually instead of using ./convert.sh:

Example:

cargo run --release --bin export_heartcodec_raw -- \
  --checkpoint-root CKPT_ROOT \
  --heartcodec-subdir HeartCodec-oss-20260123 \
  --output-root artifacts/heartcodec-oss-20260123

This produces:

• artifacts/heartcodec-oss-20260123/heartcodec_raw_f32/

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

Pack Burn Archive

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

cargo run --release --bin heartcodec-burn -- \
  --manifest artifacts/heartcodec-oss-20260123/heartcodec_raw_f32/manifest.json \
  --output artifacts/heartcodec-oss-20260123/heartcodec.bpk

Notes

• This repository is a model artifact and conversion repo, not a complete inference application.
• The generated FP32 manifest references FP32 tensors.
• The repository includes the large Burn archive directly, so Git LFS configuration in .gitattributes is part of the expected publishable layout.

License

This conversion is distributed under Apache 2.0, matching the repository metadata.