amanning3390/hermeshub

HermesHub

The ARD-compliant agent registry. Publish your agent's capabilities, become discoverable by any ARD-compatible client.

Live site: hermeshub.xyz · FAQ · ARD spec

Operated autonomously by a Hermes Agent (by Nous Research) on NVIDIA GPU infrastructure. Capability-based search. Subscription billing via Stripe.

What It Is

HermesHub is a production registry implementing the Agentic Resource Discovery (ARD) v0.9 specification. Agents publish their capabilities via /.well-known/ai-catalog.json at their own endpoint. The Hermes Agent crawls, validates, and indexes them. Any ARD-compatible client can discover agents through the standard POST /search endpoint.

Two Paths to Discovery

1. Self-published (free): Host /.well-known/ai-catalog.json at your domain. The Hermes Agent discovers and indexes it automatically.
2. Hosted listing ($5/month): Register via the dashboard. HermesHub hosts your agent card, runs health checks, and includes you in the search index. Billed via Stripe.

What the Hermes Agent Does

The registry is operated autonomously by a Hermes Agent running 24/7:

• Crawls and indexes published manifests
• Validates manifests against the ARD JSON Schema
• Indexes agents by declared capabilities and keywords
• Health-checks every listed agent endpoint every 15 minutes
• Processes registrations and Stripe subscription billing
• Maintains federation with GitHub Agent Finder and Hugging Face Discover

Technology

ARD Compliance

HermesHub implements the full ARD v0.9 specification:

• GET /.well-known/ai-catalog.json — root capability manifest
• GET /.well-known/ard-compliance.json — compliance self-attestation
• GET /.well-known/agent-card/:handle — A2A-compliant agent cards
• POST /api/v1/search — ranked discovery with query.text, query.filter, federation, pagination
• POST /api/v1/explore — facet aggregation for browsing
• Federation modes: none, referrals
• Standard error envelope with all five ARD error codes
• Trust manifests with identity attestations

The ARD specification was authored by contributors from Google, Microsoft, and Hugging Face. Working group participants include NVIDIA, AWS, Cisco, Databricks, GitHub, GoDaddy, Salesforce, and Snowflake.

Quick Start

List your agent (self-published, free)

1. Create /.well-known/ai-catalog.json at your domain:

{
  "specVersion": "1.0",
  "host": { "displayName": "My Agent" },
  "entries": [
    {
      "identifier": "urn:air:yourdomain.com:agent:my-agent",
      "displayName": "My Agent",
      "type": "application/a2a-agent-card+json",
      "url": "https://yourdomain.com/agent-card.json",
      "capabilities": ["hct:code:review:pr"],
      "representativeQueries": ["review my pull request"]
    }
  ]
}

2. The Hermes Agent will discover and index it automatically.

List your agent (hosted, $5/month)

1. Visit hermeshub.xyz
2. Click "List Your Agent"
3. Fill in your agent's name, endpoint, and capabilities
4. Complete the $5/month Stripe subscription
5. Your agent is listed and health-checked

Search the registry

curl -X POST https://hermeshub.xyz/api/v1/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "text": "code review agent",
      "filter": { "capabilities": ["hct:code:review:pr"] }
    },
    "pageSize": 5
  }'

Development

# Install dependencies
npm install

# Run dev server
npm run dev

# Run tests
npm test

# Push schema to database
npm run db:push

# Seed capabilities
npm run seed:capabilities

Environment Variables

See .env.example for required environment variables.

License

MIT