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

# Add a Model

> Register a new model in Eval by uploading a model archive or importing one from HuggingFace.

Every evaluation and inference run starts from a model in your workspace. Adding one is a quick two-part flow: give the model a name, then choose where its weights come from. You can upload your own archive or import a model straight from HuggingFace.

***

## Two ways to add a model

| Source       | Use when                                                                        | What you provide                                                 |
| ------------ | ------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **File**     | You have your own weights, such as a fine-tuned checkpoint or a merged adapter. | A `.zip` archive containing `config.json` and the model weights. |
| **HF model** | You want a public model from the HuggingFace Hub.                               | A search term, then pick the model from the results.             |

***

## Steps

### 1. Open the Models page and click Add Model

In the **Eval** tab, click **Models** in the left sidebar, then click **+ Add Model** in the top right of the **AI Models** page.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/01-models-add-button.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=fc0c059804261c4a6d497a0a1b74d551" alt="The AI Models page with the Add Model button in the top right" width="1478" height="941" data-path="images/eval/add-model/01-models-add-button.jpg" />

### 2. Enter the basic details

The **Add Model** panel slides in. Give the model a **name** (for example `myqwen3-0.6b-model`) and, optionally, a short **description**. You can edit the description later, so it's fine to leave it blank for now.

Click **Add Model** to continue. You'll choose where the weights come from on the next step.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/02-basic-details.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=269a4014ef4fa48e7b97d7d5fa5b4c7b" alt="The Add Model panel with the model name and description fields" width="1478" height="941" data-path="images/eval/add-model/02-basic-details.jpg" />

<Tip>
  Pick a name you'll recognize later in model lists and leaderboards. Avoid throwaway names like `test1`.
</Tip>

### 3. Choose where the model comes from

The model is created in a **Draft** state and opens to its model card. The **Add Model** card prompts you to choose a source. Pick one of the two tabs.

#### Option A — Upload a file

On the **File** tab, drag and drop a model archive onto the upload area, or click **Browse Files** to pick it. The archive should be a `.zip` containing `config.json` and the model weights.

Once the file is attached, click **Add model**.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/03-source-file.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=6dd7b6c1de2b8504084721297ac89b01" alt="The File tab showing the drag-and-drop upload area" width="1478" height="941" data-path="images/eval/add-model/03-source-file.jpg" />

#### Option B — Import from HuggingFace

On the **HF model** tab, type a model name into **Search HuggingFace models** (for example `llama`, `qwen`, or `mistral`).

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/04-source-hf.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=a1e45769060dd6451406d4f61fc2a055" alt="The HF model tab with the HuggingFace search box" width="1478" height="941" data-path="images/eval/add-model/04-source-hf.jpg" />

As you type, matching models appear with their download count, likes, and task tag. Click the one you want.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/05-hf-search.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=09894ac0e660a6db9366da76cec01924" alt="HuggingFace search results for qwen" width="1478" height="941" data-path="images/eval/add-model/05-hf-search.jpg" />

The selected model shows as a chip, and the **Add model** button becomes active. Click **Add model** to import it.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/06-hf-selected.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=3114b8903e0aac28aabdb9aaf8be1807" alt="A HuggingFace model selected with the Add model button enabled" width="1478" height="941" data-path="images/eval/add-model/06-hf-selected.jpg" />

### 4. Confirm the model is ready

BenchGen registers the model and provisions its endpoint. When it finishes, the status badge changes to **ready** and the model card's endpoint panel fills in with its **LiteLLM Name**, **Endpoint URL**, access **Token**, and basic information such as format and visibility.

<img src="https://mintcdn.com/benchgen-8fc81371/GS-jE79kedyHq-tA/images/eval/add-model/07-model-ready.jpg?fit=max&auto=format&n=GS-jE79kedyHq-tA&q=85&s=caa8114aa11a649a32bb8900a9aeae8a" alt="The model card after import, showing a ready status and endpoint details" width="1478" height="941" data-path="images/eval/add-model/07-model-ready.jpg" />

Your model now appears in the **Models** list and is available for inference and evaluation.

***

## Next Steps

* [Deploy an inference model](/eval/run-an-inference-model)
* [Evaluate an inference model](/eval/evaluate-a-running-model)
* [Run a benchmark](/eval/run-a-benchmark)
