Summary

Hermes Atlas is a community-curated directory mapping the rapidly expanding ecosystem of tools, skills, and integrations for the Hermes Agent AI. It serves developers, researchers, and users by providing a centralized, searchable, and up-to-date map of the ecosystem, enhanced by live data and a RAG-powered chatbot for efficient discovery and information retrieval.

How It Works

This project employs a Vercel-hosted architecture with a vanilla HTML/CSS/JavaScript frontend. Live GitHub star counts are fetched via GraphQL API and cached in Redis Cloud (1hr TTL). A RAG-powered chatbot, 'Ask the Atlas,' answers queries about Hermes Agent, grounded in 27 research files. It uses hybrid retrieval (BM25 + cosine, MMR re-ranking) and conversation-aware query rewriting, leveraging a chain of LLMs via OpenRouter (Gemma 4 31B primary) and pre-computed OpenAI embeddings.

Quick Start & Requirements

Clone the repo; run npm install for API/chunk builder dependencies. Rebuild chatbot knowledge base with OPENROUTER_API_KEY=sk-or-... node scripts/build-chunks.js. Test RAG locally via OPENROUTER_API_KEY=sk-or-... node scripts/test-rag.js. Preview static site by opening index.html. Deployment requires GITHUB_TOKEN and REDIS_URL environment variables; OPENROUTER_API_KEY is essential for chatbot functionality.

Highlighted Details

• Features 80+ quality-filtered, security-reviewed repos across 12 categories.
• Integrates live GitHub star counts and trending data with sparklines.
• Offers a RAG chatbot grounded in 27 curated research files.
• Frontend uses vanilla JS/HTML/CSS, requiring no build step.

Maintenance & Community

A community project by @ksimback, celebrating Nous Research's work but not officially affiliated. Contributions are welcomed via issues for potential Hermes Agent projects. Inclusion criteria focus on projects created post-July 22, 2025, demonstrating genuine effort and ecosystem value.

Licensing & Compatibility

Site code is MIT licensed, permitting commercial use. Research content is CC BY 4.0 (requires attribution). Metadata is sourced from upstream projects.

Limitations & Caveats

API endpoints and dynamic features function only when deployed to Vercel. Local full-stack operation requires specific API keys (OpenRouter, GitHub). This is a community initiative without official Nous Research endorsement.