> ## Documentation Index
> Fetch the complete documentation index at: https://opensource.weam.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a HuggingFace API Key

Access thousands of state-of-the-art AI models through HuggingFace's comprehensive platform.

## Step-by-Step Guide

### Step 1: Navigate to HuggingFace

Go to [https://huggingface.co](https://huggingface.co) in your web browser.

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_30_AM.png" alt="HuggingFace Homepage" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 2: Sign In or Create Account

**New User:**

* Click **"Sign Up"** in the top right corner
* Create account with email or use GitHub/Google login
* Complete email verification process

**Existing User:**

* Click **"Log In"** and enter your credentials

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_30_AM-02.png" alt="HuggingFace Login" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 3: Access Your Profile

Click on your **profile icon** in the top right corner of the page after logging in.

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-–-The-AI-community-building-the-future-07-24-2025_11_31_AM.png" alt="Profile Menu Access" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 4: Navigate to Access Tokens

In the dropdown menu, click **"Access Tokens"** (located just below "Settings").

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_12_20_PM.png" alt="Access Tokens Menu" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 5: Create New Token

Click **"Create new token"** to start the token generation process.

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_38_AM.png" alt="Create New Token" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 6: Choose Token Type

Select the appropriate token type for your needs:

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_39_AM.png" alt="Token Type Selection" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

#### Token Types Comparison

| Token Type       | Access Level          | Best For                          | Permissions                         |
| ---------------- | --------------------- | --------------------------------- | ----------------------------------- |
| **Read**         | Read-only access      | Weam integration, model inference | View public repositories and models |
| **Write**        | Read and write access | Model development, uploads        | Modify repositories, upload models  |
| **Fine-grained** | Custom permissions    | Enterprise, specific needs        | Granular control over features      |

**For Weam Integration: Choose "Read" token**

### Step 7: Configure Token Settings

#### For Read Token (Recommended for Weam):

1. Enter a descriptive token name:
   * `Weam Integration`
   * `Production API Access`
   * `Development Testing`

2. Click **"Create token"**

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_40_AM.png" alt="Token Configuration" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

#### For Fine-grained Tokens (Advanced):

Configure specific permissions:

* **Repositories**: Access to specific model repositories
* **Inference**: Model inference capabilities
* **Webhooks**: Event notifications
* **Billing**: Account billing access
* **Organizations**: Team-level permissions

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_42_AM.png" alt="Fine-grained Token Configuration" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 8: Create Your Token

Click **"Create token"** after configuring all settings.

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_43_AM.png" alt="Final Token Creation" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 9: Secure Your Token

1. **Copy immediately**: Your token is displayed only once
2. **Store securely**: Save in password manager or secure environment
3. **Never share publicly**: Keep confidential and secure
4. **Monitor usage**: Check usage in your dashboard regularly

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_11_41_AM.png" alt="Token Security Warning" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Step 10: Add to Weam

Integrate your HuggingFace token with Weam:

1. Open Weam and go to **Settings** → **Configurations**
2. Select **HuggingFace** as your provider
3. Paste your token in the configuration field
4. Save and test with an open-source model

## Token Management Dashboard

After creation, manage all your tokens from the centralized dashboard:

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-Key-Dashboard.png" alt="Token Management Dashboard" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Dashboard Features

* **Token Overview**: View all active tokens
* **Usage Monitoring**: Track API usage per token
* **Security Management**: Revoke or regenerate tokens
* **Permission Review**: Audit token permissions

## Account Settings Overview

HuggingFace provides comprehensive account management:

<img src="https://weam.ai/app/uploads/2025/07/Hugging-Face-%E2%80%93-The-AI-community-building-the-future-07-24-2025_12_24_PM.png" alt="HuggingFace Settings Panel" style={{ border: '1px solid #ccc', borderRadius: '8px', marginTop: '16px' }} />

### Key Settings Sections

| Section                 | Purpose                                 |
| ----------------------- | --------------------------------------- |
| **Profile**             | Personal information and public profile |
| **Account**             | Basic account settings and preferences  |
| **Authentication**      | Two-factor auth and security settings   |
| **Organizations**       | Team collaboration and shared resources |
| **Billing**             | Subscription plans and payment methods  |
| **Access Tokens**       | API token management                    |
| **Inference Providers** | Third-party deployment configurations   |
| **Notifications**       | Email and web notification preferences  |

## HuggingFace Platform Capabilities (2025)

### Model Ecosystem

**60,000+ Models Available:**

* **Language Models**: BERT, GPT variants, T5, RoBERTa, specialized LLMs
* **Image Generation**: Stable Diffusion, DALL-E variants, artistic models
* **Computer Vision**: Object detection, classification, image analysis
* **Audio Processing**: Speech recognition, text-to-speech, music generation
* **Multimodal**: Text + image, audio + vision combinations

### Serverless Inference API

**Production-Ready Deployment:**

* **Pay-as-you-go**: Only pay for actual compute usage
* **Auto-scaling**: Handles traffic spikes automatically
* **Global availability**: Fast inference worldwide
* **Enterprise security**: Private endpoints and VPC integration

### Popular Model Categories

#### Text Processing

* **Conversational AI**: ChatGPT alternatives, dialogue models
* **Text Generation**: Creative writing, code generation, summarization
* **Classification**: Sentiment analysis, content moderation
* **Translation**: Multi-language translation models

#### Image & Vision

* **Image Generation**: Create art, photos, illustrations
* **Image Analysis**: Object detection, scene understanding
* **Image Editing**: Style transfer, enhancement, manipulation
* **OCR & Document**: Text extraction, document analysis

#### Audio & Speech

* **Speech Recognition**: Convert speech to text
* **Text-to-Speech**: Generate natural-sounding speech
* **Music Generation**: Create music and audio effects
* **Audio Classification**: Sound recognition and analysis

## Integration Options

### Programming Languages

* **Python**: `transformers`, `huggingface_hub`, `diffusers`
* **JavaScript**: `@huggingface/inference`, web-based applications
* **cURL**: Direct REST API calls for any language
* **Gradio**: Build interactive demos and UIs

### Frameworks & Tools

* **Transformers**: Most popular library for NLP models
* **Diffusers**: Specialized for image generation models
* **Datasets**: Access and process datasets
* **Accelerate**: Optimize model training and inference

***
