huggingface

type Client struct {
	// contains filtered or unexported fields
}

type File struct {
	// Path is the file's path within the repository, for example "model.safetensors"
	// or "tokenizer.json".
	Path string
	// Size is the file's size in bytes.
	Size int64
	// SHA256 is the content hash, present only for an LFS-tracked file (the large
	// weights), taken from the Hub's recorded LFS object id. It is empty for a small
	// git-tracked file, whose Hub object id is a git blob hash, not a content sha256;
	// such a file's digest is established by hashing it on download instead.
	SHA256 string
	// LFS reports whether the file is stored in LFS (the large binary objects). An LFS
	// file carries a usable SHA256; a non-LFS file does not.
	LFS bool
}

type Info struct {
	// ID is the canonical "owner/name" identifier the Hub returns.
	ID string
	// Author is the publishing namespace.
	Author string
	// License is the SPDX-style license id from the model card, when declared.
	License string
	// Tags are the model-card tags, which carry signals like the pipeline type and the
	// base library.
	Tags []string
	// Gated reports whether the repo requires accepting terms before download, so a
	// caller can warn that an automated fetch will not succeed unattended.
	Gated bool
}

type Option func(*Client)

type SearchQuery struct {
	// Text matches free-form against a repo id and its card. Empty matches everything.
	Text string
	// Filters are model-card tags that are all required (ANDed), for example
	// "text-generation" or "safetensors". A result carries every filter it is matched on.
	Filters []string
	// Author restricts results to a single publishing namespace, for example "Qwen".
	Author string
	// Sort orders the results: "downloads" (default), "likes", or "modified". An
	// unknown value falls back to downloads so a typo never returns an unordered page.
	Sort string
	// Limit caps the number of results. It is clamped to a sane range so a caller can
	// neither ask for zero nor pull an unbounded page.
	Limit int
}

type SearchResult struct {
	// ID is the canonical "owner/name" identifier, the reference bless and run accept.
	ID string
	// Downloads is the last-30-day download count, the Hub's popularity signal.
	Downloads int64
	// Likes is the number of users who have starred the repo.
	Likes int64
	// Pipeline is the model-card pipeline tag, for example "text-generation".
	Pipeline string
	// Library is the declared base library, for example "transformers" or "gguf".
	Library string
	// Tags are the model-card tags, which carry the weight-format signal (a repo with
	// safetensors weights is tagged "safetensors", a GGUF repo "gguf").
	Tags []string
}