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