Skip to main content
The Hugging Face Connector exports trained AI models from Narrative’s model repository to Hugging Face Hub, making them available for inference and sharing.

Overview

Unlike audience delivery connectors that push data to advertising platforms, the Hugging Face Connector handles model delivery. After you train a model in Narrative’s Model Studio, the connector uploads it to your Hugging Face account as a private model repository. Delivered models include:
  • All model weights and configuration files
  • Inference files (handler.py and requirements.txt) for Hugging Face’s inference infrastructure
  • A version tag (e.g., v1) for tracking model iterations

Guides

Setting Up the Hugging Face Connector

Connect a Hugging Face access token

Requirements

Hugging Face access token

You need a Hugging Face User Access Token with write permissions. The connector supports two token types:
Organization tokens and other non-user token types are not supported. The token must be a User Access Token.
The token must grant write access to at least one model repository, organization, or user namespace.

Delivery destinations

When delivering a model, you choose where it goes on Hugging Face:

Delivering a model

Model delivery happens automatically after training completes in Model Studio:
  1. Train a model in Model Studio by selecting a base model, training dataset, and compute instance
  2. Once training finishes, a delivery job is created that uses your connector profile
  3. The connector downloads the model from Narrative’s model store, prepares inference files, and uploads everything to Hugging Face Hub
  4. The model appears as a private repository in your Hugging Face account, tagged with the model version
Delivery can take up to 30 minutes depending on model size. The process is idempotent—if a delivery is interrupted, it can safely retry without creating duplicates.

Troubleshooting

Token validation errors

Expired or revoked token

If your token expires or is revoked after profile creation, the profile detail page displays a warning. Contact Narrative Support to resolve the issue—you’ll need to create a new profile with a valid token.

Related content

Connectors Overview

Reference documentation for all available connectors

Data Activation Overview

Understand how connectors deliver data