Create a Hugging Face Repository

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

This topic describes how to create a Hugging Face repository. This is required before deploying and resolving Hugging Face packages. Artifactory supports the following kinds of Hugging Face repositories:

  • Local repositories: Store and share first- and second-party packages with your organization

  • Remote repositories: Download packages from https://huggingface.co

  • Virtual repositories: Aggregate remote and local repositories, enabling your organization to scale by providing a single URL that provides access to multiple repositories and types

To learn more about repository structure for local and remote repositories, see Hugging Face Repository Structure (Legacy).

Note

Hugging Face organizations, model names, and revision identifiers deployed to local Artifactory repositories must follow specific naming conventions and limitations. For more information, see Hugging Face Limitations in Artifactory.

For more information on JFrog repositories, see Repository Management Overview.

Prerequisite: You need Admin or Project Admin permissions in Artifactory to create a repository. If you don't have Admin permissions, the option will not be available.

To create a Hugging Face repository:

Warning

Hugging Face Repository Layout Deprecation

As of June 2026, the Hugging Face repository layout will be deprecated.

All new local and remote Hugging Face repositories use the new Machine Learning repository layout by default. Any older repositories must be migrated before June 2026 to preserve complete functionality.

For more information, see Migrate Legacy Hugging Face Repositories.

  1. In the Administration tab, click Repositories > Create a Repository.

    CreateAnsibleLocal1.png

  2. Select the type of repository you want to create: Local, Remote, or Virtual.

  3. Select the Hugging Face package type.

  4. Configure the required fields for the repository:

    • For local repositories, in the Repository Key field, type a meaningful name for the repository. For example, huggingface-local. For more information on local repositories and their settings, see Local Repositories.

    • For remote repositories, verify the Repository URL. The only supported remote URL for Hugging Face repositories in Artifactory is https://huggingface.co. For more information on remote repositories and their settings, see Remote Repositories.

      To configure a remote repository to resolve models from a private repository, see Resolve Hugging Face Models From Private Repositories.

    • For virtual repositories, select one or more local or remote repositories to include in the virtual repository. For more information on virtual repositories and their settings, see Virtual Repositories.

  5. Click Create Repository. The repository is created and the Repositories window is displayed.