hf

package
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 30, 2026 License: EPL-2.0 Imports: 16 Imported by: 0

Documentation

Overview

Package hf pulls AI model artifacts from Hugging Face Hub registries.

Index

Constants

This section is empty.

Variables

View Source
var ErrMultiGGUF = errors.New("multiple GGUF files require an explicit spec.files list")

ErrMultiGGUF is returned when a repository has more than one GGUF file and spec.files is empty.

Functions

func ExpandFiles

func ExpandFiles(patterns, repoFiles []string) ([]string, error)

ExpandFiles expands spec.files against a repository listing. Exact paths must exist; globs that match nothing return an error with a hint.

func GGUFPaths

func GGUFPaths(repoFiles []string) []string

GGUFPaths returns repository-relative paths that end in .gguf.

func GuardMultiGGUF

func GuardMultiGGUF(repoFiles []string) error

GuardMultiGGUF errors when more than one GGUF is present and the caller did not select files explicitly.

func ValidateFileSelection

func ValidateFileSelection(repoFiles, requested []string) error

ValidateFileSelection checks Hub file-selection rules against a listing. An empty requested list triggers the multi-GGUF guard; otherwise globs and exact paths are expanded.

Types

type Adapter

type Adapter struct {
	// HTTPClient, when set, is used instead of the registry-derived client (tests).
	HTTPClient *http.Client
	// RepoClass selects /api/models/ (default) or /api/datasets/. Knowledge always uses dataset.
	RepoClass RepoClass
}

Adapter pulls Hugging Face Hub artifacts into {metadata.name}/content/.

func (*Adapter) Pull

func (a *Adapter) Pull(ctx context.Context, req modelpull.Request) (*modelpull.Result, error)

Pull fetches Hub files, writes them under content/, and records manifest.json. Hugging Face pulls never write oci-store/.

type File

type File struct {
	Path string
	Size int64
}

File is one repository path at a revision.

type Info

type Info struct {
	SHA   string
	Files []File
}

Info is Hub metadata for a repository revision.

type RepoClass

type RepoClass string

RepoClass selects the Hub repository class (model vs dataset).

const (
	// RepoClassModel uses /api/models/.
	RepoClassModel RepoClass = "model"
	// RepoClassDataset uses /api/datasets/. Knowledge always uses this class.
	RepoClassDataset RepoClass = "dataset"
)

func NormalizeRepoClass

func NormalizeRepoClass(class RepoClass) RepoClass

NormalizeRepoClass maps an empty or unknown class to model.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL