Update README.md

README.md

@@ -1,10 +1,67 @@
 ---
 title: README
-emoji: 🦀
+emoji: 🐸
 colorFrom: gray
 colorTo: purple
 sdk: static
 pinned: false
 ---
 
-Edit this `README.md` markdown file to author your organization card.
+# 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)!
+
+**Join this org to get $10 free Inference Provider credits!**
+
+## 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 Toad
+
+```bash
+toad
+```
+
+Select **"Hugging Face Inference Providers"** from the agent store.
+
+### 4. Switch models
+
+Use `/set-model` in the chat to change the active model for your session.
+
+## Your Free Credits
+
+As a member of this org, you receive **$10 in free Inference Provider credits**.
+Use them to explore hundreds of open models from dozens of providers!
+
+**Note:** To receive credits, you'll need to add a payment method to your [Hugging Face billing settings](https://huggingface.co/settings/billing). This is for account 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)