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

# Quickstart

> Run your first evaluation in under five minutes.

## Prerequisites

* Python 3.10+
* A GPU (for local HF/vLLM models) or an API key (for LiteLLM backends)

## 1. Install

Install straight from GitHub — no clone required:

```bash theme={null}
pip install "mill-eval @ git+https://github.com/haideraltahan/Mill.git"
```

## 2. Run a text evaluation

```bash theme={null}
mill eval "meta-llama/Meta-Llama-3-8B-Instruct[dtype=bfloat16,batch_size=8]" mmlu \
  --output_dir ./results
```

Mill streams progress to your terminal and writes a Feather file to `./results/` when done.

## 3. View results

```bash theme={null}
mill --output_dir ./results collect --metric acc
```

The `collect` command renders a table of scores in your terminal. Pass `--metric` to choose which metric to show — MMLU reports `acc`:

```text theme={null}
Mill results — performance (acc)
┌─────────────────────────────────────┬────────┐
│ model                               │ mmlu   │
├─────────────────────────────────────┼────────┤
│ meta-llama/Meta-Llama-3-8B-Instruct │ 0.6398 │
└─────────────────────────────────────┴────────┘
```

## 4. Browse available tasks

```bash theme={null}
mill ls
```

This opens a full-screen TUI browser. Use `↑ ↓` to navigate, `Tab` to switch between Benchmarks and Tasks, and `Enter` to copy a task name to your clipboard.

## Next steps

<CardGroup cols={2}>
  <Card title="Text evaluation guide" href="/docs/guides/text-evaluation">
    Few-shot, custom metrics, and n-shot sweeps.
  </Card>

  <Card title="Vision evaluation guide" href="/docs/guides/vision-evaluation">
    Multimodal models with image/video inputs.
  </Card>

  <Card title="Distributed scheduling" href="/docs/guides/distributed">
    Scale across a SLURM cluster.
  </Card>

  <Card title="CLI reference" href="/docs/reference/cli">
    Full flag documentation.
  </Card>
</CardGroup>