Hermes Agent

Alternative AI Agent Framework

96 Built-in Skills
30 Core Tools
MIT Licensed

NousResearch • v0.5.0 • 8.8k GitHub Stars

What is Hermes Agent?

  • Open-source AI agent framework
  • Python-based with uv package manager
  • Multi-platform support (Discord, Telegram, CLI)
  • Extensive skill ecosystem
  • Thread-based conversations

Built by NousResearch as a comprehensive agent platform.

Key Features

  • 96 bundled skills - web search, coding, file ops, etc.
  • 30 core tools - shell, browser, memory, etc.
  • Custom providers - support any API format
  • Pairing system - secure user authorization
  • Workspace isolation - per-user environments

Installation

# One-line installer curl -fsSL https://raw.githubusercontent.com/\ NousResearch/hermes-agent/main/scripts/install.sh | bash # Manual setup hermes gateway setup hermes gateway start

Installs uv, Python 3.11+, ripgrep, Node.js automatically.

Configuration

# ~/.hermes/config.yaml model: default: claude-opus-4-6 provider: ccvibe custom_providers: - name: ccvibe base_url: https://ccvibe.vip/v1 api_key: sk-... api_mode: anthropic headers: x-api-key: sk-...

Flexible provider system supports any API format.

Hermes vs OpenClaw

Hermes Agent

  • 96 built-in skills
  • Thread-based chats
  • Pairing authorization
  • Python ecosystem
  • YAML config
  • uv package manager

OpenClaw

  • Custom skill system
  • Inline conversations
  • Channel-based auth
  • Node.js ecosystem
  • JSON config
  • npm package manager

Our Migration Experience

  • Loki server - migrated from OpenClaw to Hermes
  • ccvibe integration - custom provider for API compatibility
  • Workspace transfer - SOUL.md, MEMORY.md, skills
  • Claude Code incompatibility - doesn't support x-api-key headers

Overall: smooth migration with some API format challenges.

Advantages

  • Rich skill ecosystem - 96 skills out of the box
  • Active development - frequent updates, community
  • Flexible providers - easy to add custom APIs
  • Thread organization - cleaner Discord conversations
  • Security model - pairing system prevents abuse

Challenges

  • Learning curve - different from OpenClaw patterns
  • Python dependency - heavier runtime requirements
  • API compatibility - some tools expect standard formats
  • Thread overhead - creates many Discord threads
  • Less customizable - more opinionated framework

When to Use Hermes

  • Rich skill requirements - need many built-in capabilities
  • Team environments - pairing system useful for access control
  • Thread-based workflows - prefer organized conversations
  • Python ecosystem - team comfortable with Python

Best for: Feature-rich deployments with security needs

Key Commands

# Chat modes hermes chat --yolo # Interactive TUI hermes chat -q "message" -Q # Non-interactive # Gateway management hermes gateway start/stop/restart hermes gateway status # User management hermes pairing list hermes pairing approve discord CODE123 # System info hermes status hermes doctor

Conclusion

Hermes Agent is a solid alternative to OpenClaw
with rich built-in capabilities and active development.

Best for: Teams needing extensive skills
Consider: API compatibility and learning curve

Both frameworks can coexist for different use cases