🗺️ Hermes Atlas
The community-curated map of every tool, skill, and integration for Hermes Agent by Nous Research.
🌐 Live site: hermesatlas.com
What is this?
Hermes Atlas is a living directory of the Hermes Agent ecosystem. Hermes Agent (the self-improving AI agent from Nous Research) launched in February 2026 and immediately spawned a fast-growing community of skills, plugins, integrations, deployment templates, and forks. This site is the canonical map of all of it.
Features:
- 80+ quality-filtered repos across 12 categories — every project security-reviewed before inclusion
- Live star counts fetched from the GitHub API and cached in Redis
- Sparklines and trending badges showing growth over time
- RAG-powered chatbot ("Ask the Atlas") that answers questions about Hermes Agent grounded in 27 research files
- Search, sort, filter across the entire ecosystem
- Light and dark mode with OS preference detection
- Mobile responsive
How it works
┌─────────────────────────────────────────────────────────────┐
│ hermesatlas.com (Vercel static + serverless) │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ index.html │ │ /api/stars │ │ /api/chat │ │
│ │ (the map) │ │ (live data) │ │ (RAG chatbot) │ │
│ └─────────────┘ └──────┬───────┘ └────────┬─────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────┐ ┌────────────┐ │
│ │ Redis │ │ Nous Portal│ │
│ │ Cloud │ │(GPT-6 Luna)│ │
│ └────┬─────┘ └────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────┐ │
│ │ GitHub │ │
│ │ GraphQL │ │
│ └──────────┘ │
└─────────────────────────────────────────────────────────────┘
Stack:
- Frontend: Vanilla HTML/CSS/JavaScript (no framework, no build step)
- Hosting: Vercel (static + serverless functions)
- Cache: Redis Cloud (1hr TTL on star counts, daily history snapshots)
- LLM: Nous Portal with a client-side fallback chain (GPT-6 Luna → Claude Haiku 5.5)
- Embeddings: OpenAI text-embedding-3-small (computed once at build time, cached as static JSON)
- Retrieval: Hybrid BM25 + cosine similarity, MMR re-ranking, conversation-aware query rewriting
Repository structure
hermes/
├── index.html # The map (single-page app)
├── api/
│ ├── stars.js # GitHub star fetch + Redis cache
│ ├── stars-history.js # 30-day history for sparklines
│ └── chat.js # RAG pipeline with streaming
├── lib/
│ └── redis.js # Shared Redis client helper
├── data/
│ ├── repos.json # Quality-filtered repos (single source of truth)
│ ├── chunks-meta.json # KB chunk text + metadata (see lib/chunk-store.js)
│ └── embeddings.bin # Pre-computed embeddings (float32, ~14MB)
├── scripts/
│ ├── build-chunks.js # Splits research/ into chunks + embeds them
│ └── test-rag.js # Local RAG quality tests (27/27 passing)
├── research/ # 27 source-of-truth research files
├── repos/ # Star count data, security review, raw search results
├── ECOSYSTEM.md # Markdown version of the map
├── package.json # Just two deps: openai, redis
└── vercel.json # Function config + daily cron
Running locally
git clone https://github.com/ksimback/hermes-ecosystem.git
cd hermes-ecosystem
# Install deps (only needed for the API endpoints + chunk builder)
npm install
# To rebuild the chatbot's knowledge base after editing research/ files:
NOUS_API_KEY=... node scripts/build-chunks.js
# To test the RAG pipeline locally:
NOUS_API_KEY=... node scripts/test-rag.js
# To preview the static site, just open index.html in a browser
# (the API endpoints only work when deployed to Vercel)
Environment variables (Vercel)
| Variable | Purpose | Required |
|---|
GITHUB_TOKEN | Fine-grained PAT, public repos read-only | For 5000/hr rate limit (60/hr without) |
NOUS_API_KEY | Nous Portal API key for chat + embeddings | Yes |
REDIS_URL | Redis Cloud connection string | Yes (for cache + history) |
CHAT_MODEL | Override primary LLM model | No (default: openai/gpt-6-luna) |
CHAT_FALLBACK_MODELS | Comma-separated fallback chain | No (default: anthropic/claude-haiku-5.5) |
LLM_BASE_URL / LLM_API_KEY | Point at another OpenAI-compatible gateway | No (default: Nous Portal) |
Contributing
Found a Hermes Agent project that should be in the map? Open an issue with the GitHub URL. Filtering criteria:
- Must be specifically built for or integrated with Hermes Agent
- Created after July 22, 2025 (Hermes repo creation date)
- Not a personal pet project or assignment
- Shows genuine effort and adds value to the ecosystem
- Passes a basic security review
License
Site code: MIT. Research content: CC BY 4.0. Repo descriptions and metadata are sourced from the upstream projects' own documentation.
Built by @ksimback. Not officially affiliated with Nous Research — community project celebrating their work.
