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

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

# Toad HF Inference Explorers

<div class="not-prose bg-gradient-to-r from-gray-50-to-white text-gray-900 border" style="border-radius: 8px; padding: 0.5rem 1rem; margin-bottom: 10px;">
  <span style="font-weight: 600;">🎁 Join this org to get $20 free Inference Provider credits!</span>
</div>

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://huggingface.co/spaces/toad-hf-inference-explorers/README/resolve/main/toad_hf_install.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 (or update) 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.

### 5. Explore Skills

Install and manage agent skills from the Hugging Face Skills repository with the `/skills` command:

<div style="text-align: center;">
  <img src="https://huggingface.co/spaces/toad-hf-inference-explorers/README/resolve/main/toad_skill_install.png" style="width: 100%; max-width: 750px; border-radius: 8px; margin: 20px 0;"/>
</div>

Once added the skill is immediately available to use. 

### 6. Try Examples

Enter setup mode (use `ctrl+o` to switch modes) and type `/quickstart` to install the following hackable examples:

<div style="text-align: center;">
  <video width="60%" controls>
    <source src="https://huggingface.co/spaces/toad-hf-inference-explorers/README/resolve/main/toad_quickstart_video.mp4">
    Your browser does not support the video tag.
  </video>
</div>



 - ACP/MCP Expert Agents -- conversationally query the Specification and Python SDK, and return responses with citations.
 - Ripgrep Search Tool -- context efficient Search Tool
 - Hugging Face Hub Search Tool -- Ask complex questions about the Hub, powered by the `hf` CLI.
 - Blog Post PR Skill -- Extract suggestions and comments from draft through to publication.

### 7. Agent Builder

Coming Soon.

## Your Free Credits

<div class="not-prose bg-gradient-to-r from-gray-50-to-white text-gray-900 border" style="border-radius: 8px; padding: 0.5rem 1rem;">
  As a member of this org, you receive <strong>$20 in free Inference Provider credits</strong> to explore hundreds of open models from dozens of providers.
</div>

<div class="not-prose bg-gradient-to-r from-gray-50-to-white text-gray-900 border" style="border-radius: 8px; padding: 0.5rem 1rem; margin-top: 10px;">
  <span style="font-weight: 600;">Note:</span> To receive credits, add a payment method to your <a class="underline" href="https://huggingface.co/settings/billing">billing settings</a>. This is for verification only—you won't be charged unless you exceed your free credits.
</div>

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