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