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:

text

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:

bash

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:

bash

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.

maolandaw/HeartCodec-oss-20260123-burn

HeartCodec-oss-20260123 (Burn Format)