---
title: README
emoji: 🐸
colorFrom: gray
colorTo: purple
sdk: static
pinned: false
---

<div style="height: 15px;"></div>

# Toad HF Inference Explorers

Explore the best open models with [Toad](https://github.com/batrachianai/toad) and [Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers).

<div style="text-align: center;">
  <img src="https://cdn-uploads.huggingface.co/production/uploads/60107b385ac3e86b3ea4fc34/OuC2rPMz8wUiR0gRjUAIv.png" style="width: 100%; max-width: 750px; border-radius: 8px; margin: 20px 0;"/>
</div>

## What is Toad?

Toad is a terminal-based interface for AI agents from [Will McGugan](https://github.com/willmcgugan), creator of Rich and Textual. It connects to AI models via the Agent Client Protocol (ACP).

## Quick Start

### 1. Install Toad

```bash
curl -fsSL batrachian.ai/install | sh
```

Or for Python developers:

```bash
uv tool install -U batrachian-toad
```

### 2. Authenticate with Hugging Face

```bash
hf auth login
```

Or set your `HF_TOKEN` environment variable.

### 3. Launch and select HF Inference Providers

```bash
toad
```

Select **"Hugging Face Inference Providers"** from the Recommended section.

### 4. Switch models

Use `/set-model` in the chat to change the active model.

## Resources

- [Toad on GitHub](https://github.com/batrachianai/toad)
- [Inference Providers Docs](https://huggingface.co/docs/inference-providers)
- [Available Models](https://huggingface.co/models?inference_provider=all)

<div style="height: 35px;"></div>