# Hugging Face Guide

## Getting Tokens for BlockAssist

BlockAssist uses Hugging Face to securely host and share AI models, linking them to your Gensyn Testnet account. Hugging Face ensures models are accessible, auditable, and reusable within the AI ecosystem.

#### Step 1 — Sign Up 

Go to [Hugging Face](https://huggingface.co/login) and click **Sign Up** in the top right to create a free account. 

* You can sign up with email/password, or through Google or GitHub
* Already have an account? Click **Sign In.** 

{% hint style="success" %}
If you have trouble signing up, try a different browser or disable ad blockers.
{% endhint %}

#### Step 3 — Verify your Email (required)

After signing up, check your inbox for a Hugging Face verification email. Then, click the link in the email to verify your address.

This step is required before you can create tokens or upload anything.

{% hint style="warning" %}
Can't find it? Check your spam folder. or log in and click **“Resend Verification”.**
{% endhint %}

#### Step 3 — Generate a New Access Token

This token allows the game to upload a model to your Hugging Face account.

1. Once signed in, click your **profile icon** (top right corner).
2. Select **“Access Tokens”** from the dropdown.
3. Click **“New token”.**
   * **Name:** something like “BlockAssist”.
   * **Role:** choose **Write.**
4. Click **“Create”.**
5. **Copy the token immediately,** as you won’t be able to see it again.

{% hint style="info" %}
When prompted to paste the token, be aware that the token will be **invisible** when pasted, so you won't see it entered into the terminal. Simply paste, then hit `enter` (Windows/Linux) or `return` (macOS).
{% endhint %}

### Common Issues

Here's some common blockers and quick fixes if you encounter any problems regarding Hugging Face:

| Issue                                             | Solution                                                                                                                                                  |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Not seeing "Access Tokens" menu                   | Make sure you’re logged in and your email is verified.                                                                                                    |
| Copied the token, but didn't save it              | Delete the lost token and generate a new one. Be sure to save it!                                                                                         |
| 403 Client Error: Forbidden                       | Your token might not have *Write* permissions, or may have expired. Generate a new token with Write access.                                               |
| Uploaded model doesn't appear on Hugging Face     | Refresh your Hugging Face profile and check under Repositories → Models and confirm you’re logged into the same Hugging Face account that owns the token. |
| Multiple tokens created, not sure which is active | Delete unused tokens in Settings → Access Tokens. Keep only the one you use for BlockAssist to avoid confusion.                                           |

### Using your New Token with BlockAssist

You're ready to go! 

Paste your token during game setup, [which you can read about here](https://docs.gensyn.ai/testnet/blockassist/using-blockassist), and start training models and contributing to the Gensyn Testnet. 

{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/blockassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn) 
{% endhint %}