Struct HfCheckpoint 

pub struct HfCheckpoint { /* private fields */ }

A Hugging Face checkpoint directory, presented as its converted GGUF.

Implementations

impl HfCheckpoint

pub fn open(dir: &Path) -> Result<HfCheckpoint>

Read the checkpoint in dir as its converted GGUF.

pub fn read_configuration( dir: &Path, ) -> Result<(String, BTreeMap<String, MetaValue>)>

The architecture and the metadata dir’s config.json alone writes, refused as HfCheckpoint::open refuses it, before any weight is read: a published configuration checked without its checkpoint. Draft blocks only the tensors count (Qwen3-Next’s) are left uncounted.

pub fn read_tokenizer(dir: &Path) -> Result<BTreeMap<String, MetaValue>>

The tokenizer keys dir’s tokenizer files and configuration write (tokenizer.*, with general.architecture), before any weight is read: a published tokenizer checked without its checkpoint.

pub fn open_with(dir: &Path, recompute: Recompute) -> Result<HfCheckpoint>

Read the checkpoint in dir, presenting computed values as recompute says.

pub fn tokenizer_meta(&self) -> Result<&BTreeMap<String, MetaValue>>

The tokenizer keys the converter writes from the directory’s tokenizer files (tokenizer.*), with general.architecture: what Vocab::from_meta reads. Read on first use.

pub fn unread(&self) -> &[String]

Tensors of the checkpoint nothing presented reads and the converter does not skip.

pub fn skipped(&self) -> &[String]

Tensors the converter skips (a multimodal checkpoint’s tower), which this reader skips too.

pub fn recomputed(&self) -> Vec<&str>

Tensors whose values a converter step computes from the stored ones, rather than reads.

pub fn shard_count(&self) -> usize

The safetensors files read.

pub fn dir(&self) -> &Path

Trait Implementations

impl SpecSource for HfCheckpoint

fn arch(&self) -> &str

general.architecture.

fn arch_meta(&self, suffix: &str) -> Option<&MetaValue>

The architecture key {arch}.{suffix}.

fn dims(&self, name: &str) -> Option<&[u64]>

A tensor’s dims, dims[0] the fastest-varying.

fn tensor_names(&self) -> Vec<&str>

Every tensor’s name, in the directory’s order.

fn has(&self, name: &str) -> bool

impl WeightSource for HfCheckpoint

fn describe(&self, name: &str) -> Result<(GgmlType, Vec<u64>)>

A tensor’s format and dims.

fn row_bytes( &mut self, name: &str, first: usize, count: usize, ) -> Result<Vec<u8>>

The bytes of rows [first, first + count), a row being the tensor’s dims[0] elements.

fn has(&self, name: &str) -> bool