> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-entitlement-lifecycle-sparse-acl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a Hugging Face connector

> C1 provides identity governance for Hugging Face. Integrate your Hugging Face organization with C1 for unified visibility and governance over user access.

C1 provides identity governance for Hugging Face. Integrate your Hugging Face
organization with C1 for unified visibility and governance over who can access
your organization and the role each member holds.

## Capabilities

| Resource     | Sync                                                          | Provision |
| ------------ | ------------------------------------------------------------- | --------- |
| Users        | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Organization | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs your Hugging Face organization and its members (users),
along with each member's organization role (**No access**, **Read**,
**Contributor**, **Write**, or **Admin**).

## Gather Hugging Face credentials

<Warning>
  The token owner must be a member of the organization you want to connect, with
  at least a read role. A token with the **read-org** scope is sufficient to list
  organization members.
</Warning>

<Steps>
  <Step>
    Sign in to Hugging Face and open **Settings** > **Access Tokens**.
  </Step>

  <Step>
    Create a new access token with the **read-org** scope. Copy the token
    (it begins with `hf_`) — it is shown only once.
  </Step>

  <Step>
    Note your organization name — the slug shown in your organization URL
    (for example, `my-org` in `https://huggingface.co/my-org`).
  </Step>
</Steps>

## Configure the Hugging Face connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Apps** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Hugging Face** and click **Add**.
      </Step>

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the Hugging Face credentials:

        * **Hugging Face API Token**: the `hf_` access token you created.
        * **Hugging Face Organization Name**: your organization slug.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your Hugging Face connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the Hugging Face connector in your own
    environment.

    <Steps>
      <Step>
        Create secrets for the Hugging Face credentials.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **Hugging Face API Token**: the `hf_` access token you created.
        * **Hugging Face Organization Name**: your organization slug.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your Hugging Face connector is now pulling access data into C1.
  </Tab>
</Tabs>