Overview
Torii integrates with Hugging Face and syncs:
- Organization members, including external collaborators: name, username, email (when available), role and avatar.
- Licenses: one Hugging Face license for each synced member.
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- A Hugging Face organization, and an administrator of that organization to create the token. Admin access is needed so Torii can see members' email addresses.
- Member emails are available only for Team or Enterprise organizations, and only for verified (SSO or verified-domain) emails. Members without an available email are still synced without one.
Required keys
- User Access Token - a Hugging Face token created by an organization administrator, with read access to the organization.
- Organization name - the name of your organization as it appears in its URL: huggingface.co/<organization name>.
How to Generate the Required Values
Step 1: Create a User Access Token
- Sign in to Hugging Face with an account that is an administrator of your organization.
- Go to Settings >> Access Tokens.
- Click Create new token.
- Enter a name for the token, for example Torii.
- Choose the token type:
- Fine-grained: under Org permissions, search for your organization and select Read org settings. Use this type if your organization only allows fine-grained tokens, since other token types are rejected for such organizations.
- Read: gives read access to everything your account can read. Works, but grants Torii more than it needs.
- If you plan to use the "Change Hugging Face organization member role" action from Torii workflows, also select Write org settings / member management for the organization.
- Click to create the token and copy it (it starts with hf_).
Important
Copy the token right after creating it and store it securely. If your organization requires administrator approval for tokens, tokens created by an organization administrator are approved automatically.
Step 2: Find your organization name
- Open your organization page on Hugging Face.
- Copy the name from the URL: huggingface.co/<organization name>.
For more details, see the Hugging Face documentation on User access tokens.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Hugging Face and click Connect.
- Enter the User Access Token and the Organization name.
- Click Connect.
Actions
Change Hugging Face organization member role
- Changes the role of a member in your Hugging Face organization.
- Requires a Team or Enterprise plan and a token that can manage the organization.
- Changing a member's role removes the member from all of their resource groups.
Q&A
Q: Why are some members synced without an email?
A: Hugging Face exposes member emails only for Team or Enterprise organizations, only when they are verified through SSO or a verified domain, and only to an administrator token.
Q: Why are external collaborators synced?
A: Hugging Face counts external collaborators toward the paid seats of your organization. They are synced only when the token belongs to an organization administrator.
Q: What happens to a member's resource groups when I change their role from Torii?
A: The member is removed from all resource groups in the organization. Re-add them in Hugging Face if needed.
For any further questions, please contact Torii Support.