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

​
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:

​
Installation

1

Navigate to the connector

In Narrative, go to Installed Apps in the left navigation and select Hugging Face Connector.
2

Add a profile

Click Add profile to begin connecting your Hugging Face account.
3

Enter your access token

Paste your Hugging Face User Access Token into the token field and click Validate.
4

Review accessible entities

After validation, expand Hugging Face Access Token Details to see the organizations, users, and model repositories your token grants write access to. These are the destinations available for model delivery.
5

Name your profile

Enter a Profile name and optional Description, then click Create.
Your profile is automatically enabled after creation and appears in the Connector profiles list on the settings page.

​
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