File size: 2,558 Bytes
c571051 8cbe388 c571051 1cda4b3 8cbe388 1cda4b3 8cbe388 bcea586 8cbe388 1cda4b3 8cbe388 1cda4b3 8cbe388 1cda4b3 4e31ca0 8cbe388 1cda4b3 8cbe388 1cda4b3 8cbe388 1cda4b3 8cbe388 1cda4b3 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 |
---
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 $10 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://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.
## 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>$10 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>
|