hf

package

v0.1.20 Latest Latest Go to latest Published: Apr 7, 2026 License: MIT Imports: 9 Imported by: 0

Details

This section is empty.

This section is empty.

func Download(ctx context.Context, p Path) ([]byte, error)

Download retrieves the contents of a file in a Hugging Face repository.

func DownloadStream(ctx context.Context, p Path) (io.ReadCloser, error)

func ListFiles(ctx context.Context, p Path) ([]string, error)

ListFiles retrieves repo files for directory-like paths.

type HTTPStatusError struct {
	StatusCode int
	Status     string
}

HTTPStatusError is returned when an HTTP request returns a non-2xx status code.

func (e *HTTPStatusError) Error() string

type Path struct {
	Repo string // owner/name
	File string // optional file path within repo
}

Path represents a Hugging Face repository or file.

func Parse(raw string) (Path, error)

Parse parses hf://owner/repo[/file] and hf://datasets/owner/repo[/file] paths.

func (p Path) DefaultFilename() string

DefaultFilename returns the filename to use when writing this path to a directory.

func (p Path) String() string

func (p Path) URL() (string, error)

URL returns the download URL for the path.