Burin · Guide

Guide

How to look inside a checkpoint, compare it with another, and edit it with a record of every change.

À venir This page is an outline. Each section below keeps its coming soon stamp until it describes code that exists in the repository.

Available now: install from source

There is no release yet. The scaffold installs from a clone of the repository:

git clone https://github.com/fonderie-dev/fonderie-burin.git
cd fonderie-burin
python -m pip install -e ".[dev]"
python -m pytest

The tests use small synthetic tensors; they need neither a GPU nor downloads.

Planned chapters

  1. Installation

    Coming soon

    Installing a released version, and the optional extras that bring in tensor libraries only when they are needed.

  2. A first inspection

    Coming soon

    An inventory of a small synthetic safetensors file: its tensors, shapes, dtypes and statistics.

  3. Tensor inventory

    Coming soon

    Reading a checkpoint lazily and reporting per-tensor shape, dtype and summary statistics without loading the whole model into memory.

  4. Comparing checkpoints

    Coming soon

    Layer-by-layer comparison of two checkpoints of the same architecture, such as a base model and its fine-tune from Affinage.

  5. Targeted edits

    Coming soon

    Rescaling, zeroing, replacing or merging tensors, always written to a new checkpoint and never in place.

  6. The change log

    Coming soon

    The record of every edit with the checksums of input and output, and how to reverse an edit from it.

  7. Verifying an edited checkpoint

    Coming soon

    Confirming that the result still loads with the expected shapes before it goes to Essai for measurement.

  8. Safe loading

    Coming soon

    Why Burin reads safetensors only and does not open pickle-based checkpoints. See safe loading.