--- title: README emoji: 🐸 colorFrom: gray colorTo: purple sdk: static pinned: false ---
# Toad HF Inference Explorers
🎁 Join this org to get $20 free Inference Provider credits!
Explore the best open models with [Toad](https://github.com/batrachianai/toad) and [Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers).
## 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:
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:
- 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
As a member of this org, you receive $20 in free Inference Provider credits to explore hundreds of open models from dozens of providers.
Note: To receive credits, add a payment method to your billing settings. This is for verification only—you won't be charged unless you exceed your free credits.
## 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)