The open registry & spec for API‑savvy LLM agents — built in public, one thoughtful file at a time.
| We Are | We Aren’t |
|---|---|
An open specification (Open Agent Spec v0.1) that any LLM stack can read. |
A proprietary prompt framework or closed vendor format. |
| A curated registry of YAML agent files—each a peer‑reviewed guide to using a specific API or SDK. | A one‑click black‑box CLI or SDK. Developers copy‑paste—or parse—the YAML any way they like. |
| A conversation starter: every agent PR includes design notes, context, and room for debate. | A “big bang” drop of autogenerated assets with no community input. |
- Quality > Quantity — We’d rather publish ten rock‑solid agents than a hundred flimsy ones.
- Transparency > Hype — All design decisions, reviews, and mistakes happen in the open.
- Collaboration > Control — Maintainers guide the vision, but contributors co‑own the future.
- Read the CONTRIBUTING guide — it walks you through our PR‑based workflow.
- Explore the founding agents in
/agents/— they set the quality bar and include transparentDESIGN_NOTES.md. - Pick an API or SDK that’s missing and start drafting your own agent. Draft PRs welcome!
- Need help? Open a Discussion or join our Discord office‑hours.
(First‑time contributors are always celebrated — add yourself to the all‑contributors grid!)
| Community Health Metric | Early‑Stage Target |
|---|---|
| Community PRs merged (first 72 h post‑launch) | ≥ 3 |
| PR review turnaround (launch week) | ≤ 12 h |
| Repeat contributors (first 2 weeks) | ≥ 5 |
Public projects tagged #BuiltWithAgentHub (first 14 days) |
≥ 5 |
| Positive sentiment ratio in HN/PH comments | > 70 % |
We care less about vanity stars and more about engaged, returning collaborators who help the registry grow sustainably.
AgentHub operates under a Code of Conduct to ensure a welcoming, harassment‑free environment for everyone.
Happy agent‑crafting! 🌱