Skip to content

tamnd/huggingface-cli

Repository files navigation

hf

Browse Hugging Face Hub models, datasets, and spaces

hf is a single pure-Go binary. It speaks to huggingface over plain HTTPS, shapes the responses into clean records, and pipes into the rest of your tools. No API key, nothing to run alongside it.

Install

go install github.com/tamnd/huggingface-cli/cmd/hf@latest

Or grab a prebuilt binary from the releases, or run the container image:

docker run --rm ghcr.io/tamnd/hf:latest --help

Usage

hf --help
hf version

This is a fresh scaffold. The command tree starts with version; build out the real commands in cli/ on top of the huggingface library package.

Development

cmd/hf/   thin main, wires cli.Root into fang
cli/                 the cobra command tree
huggingface/                the library: HTTP client and data models
docs/                tago documentation site
make build      # ./bin/hf
make test       # go test ./...
make vet        # go vet ./...

Releasing

Push a version tag and GitHub Actions runs GoReleaser, which builds the archives, Linux packages, the multi-arch GHCR image, checksums, SBOMs, and a cosign signature:

git tag v0.1.0
git push --tags

The Homebrew and Scoop steps self-disable until their tokens exist, so the first release works with no extra secrets.

License

Apache-2.0. See LICENSE.

About

Browse Hugging Face Hub models, datasets, and spaces as structured records from the terminal

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors