Hugging Face

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
HF_TOKENYesHugging Face access token (starts with hf_) Docs.

Setup

  1. Create a Hugging Face account: Go to https://huggingface.co and sign up or sign in. Hub API access and a generous Inference Providers free tier are available without billing.
  2. Create an access token: Open https://huggingface.co/settings/tokens and create a fine-grained token. Enable 'Make calls to Inference Providers' if you want to use the chat completion tool; read access covers the Hub search tools.
  3. Store the token: Copy the token and add it to your .env file as HF_TOKEN=hf_...
  4. Verify access: Run the Who Am I tool to confirm the token works and shows the expected permissions.

Provider notes

  • Hub search endpoints work with read-scoped tokens; chat completions require the Inference Providers permission
  • Inference Providers usage beyond the free tier is billed at provider rates with no markup; PRO accounts include monthly credits
  • Some gated models (e.g. meta-llama) require accepting their license on the Hub before access

Provider API reference.

Tools

ToolAccessDescription
Search Models<br /><code className="reference-identifier">huggingface__search_models</code>ReadSearch models
Get Model<br /><code className="reference-identifier">huggingface__get_model</code>ReadGet model
Search Datasets<br /><code className="reference-identifier">huggingface__search_datasets</code>ReadSearch datasets
Who Am I<br /><code className="reference-identifier">huggingface__whoami</code>ReadGet account identity
Create Chat Completion<br /><code className="reference-identifier">huggingface__create_chat_completion</code>WriteGenerate chat completion

Verify the connection

Call a read tool such as huggingface__search_models with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.