Hugging Face Guide

Follow this quick tutorial to sign up for Hugging Face and generate a private token for use with BlockAssist.

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 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.

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.

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 - you won’t be able to see it again.

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, and start training models and contributing to the Gensyn Testnet.

Last updated