HuggingFace

Protocol: huggingface://
Default model: None

Key envHF_TOKEN, HUGGINGFACE_API_KEY

LicensePro

Runs the models HuggingFace Inference Providers serve, on its OpenAI-compatible router at https://router.huggingface.co/v1. Name the model with ?model=: without one, a formatter exits with code 5 and a navigator fails the navigation with code 9.

Options

Option	On HuggingFace
`vision`	On by default for a model whose name holds one on the Ollama list, or `olmocr`, `tarsier2`, `smolvlm2` or `idefics2`
`body.<path>`	Fields OpenAI’s chat request names
`header`, `max_tokens`, `temperature`, `top_p`, `frames`, `timeout`, `insecure`	As listed

Example

CLI Run locally

zshot -t llm_text \
  --llm-format-model "huggingface://?model=openai/gpt-oss-120b" \
  --llm-format-prompt "Summarize the lead story in one sentence." \
  -f summary.txt https://zshot-cli.com/example_assets/gazette/