{
  "id": "page:docs-hermes-research-raw-github-readme",
  "_kind": "Page",
  "_file": "wiki/docs/hermes-research/raw/github-readme.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/hermes-research/raw/github-readme.md",
    "sourceKind": "repo-docs",
    "title": "Hermes Agent - GitHub README",
    "displayName": "Hermes Agent - GitHub README",
    "slug": "docs/hermes-research/raw/github-readme",
    "articlePath": "wiki/docs/hermes-research/raw/github-readme.md",
    "article": "\n# Hermes Agent - GitHub README\n\n> Source: https://github.com/NousResearch/hermes-agent\n\n## Overview\n\nHermes Agent is an autonomous AI system developed by Nous Research that operates across multiple platforms. It features a built-in learning mechanism, persistent memory systems, and the ability to function on various infrastructure setups -- from modest $5 VPS deployments to GPU clusters and serverless environments.\n\n## Core Features\n\n**Self-Improving Architecture**\nThe agent creates and refines skills autonomously, maintains conversational history with full-text search capabilities, and develops user profiles that persist across sessions.\n\n**Multi-Platform Access**\n\"Telegram, Discord, Slack, WhatsApp, Signal, and CLI -- all from a single gateway process.\" The system supports voice transcription and maintains conversation continuity across platforms.\n\n**Terminal Interface**\nA comprehensive TUI offering multiline editing, command autocomplete, conversation history, interrupt functionality, and streaming tool output.\n\n**Flexible Model Support**\nCompatible with numerous providers including Nous Portal, OpenRouter (200+ models), NovitaAI, NVIDIA NIM, OpenAI, and custom endpoints. Model switching occurs without code modifications.\n\n**Scheduled Automation**\nBuilt-in cron scheduler enabling natural-language task automation for recurring operations like daily reports or weekly audits.\n\n**Distributed Execution**\nCapability to spawn isolated subagents for parallel workstreams and collapse multi-step Python scripts into zero-context-cost operations.\n\n## Installation\n\n**Linux/macOS/WSL2/Termux:**\n```bash\ncurl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\niex (irm https://hermes-agent.nousresearch.com/install.ps1)\n```\n\nThe Windows installer provides bundled Git Bash (MinGit), Python 3.11, Node.js, ripgrep, and ffmpeg without requiring administrator privileges.\n\n## Quick Start Commands\n\n- `hermes` -- Launch interactive CLI\n- `hermes model` -- Select LLM provider\n- `hermes tools` -- Configure enabled tools\n- `hermes gateway` -- Start messaging platform bridge\n- `hermes setup` -- Full configuration wizard\n- `hermes update` -- Update to latest version\n\n## Messaging & CLI Reference\n\n| Action | CLI | Messaging |\n|--------|-----|-----------|\n| Start conversation | `hermes` | Setup gateway, then message bot |\n| New conversation | `/new` or `/reset` | `/new` or `/reset` |\n| Change model | `/model [provider:model]` | `/model [provider:model]` |\n| Retry/undo | `/retry`, `/undo` | `/retry`, `/undo` |\n| Interrupt work | `Ctrl+C` | `/stop` or new message |\n\n## Technical Stack\n\n**Languages:** Python (83.6%), TypeScript (12.6%), JavaScript (1.0%)\n\n**Key Components:**\n- Agent loop with tool-calling architecture\n- FTS5 session search with LLM summarization\n- Memory system compatible with Honcho user modeling\n- Skills standard aligned with agentskills.io\n- MCP (Model Context Protocol) integration support\n- Terminal backends: local, Docker, SSH, Singularity, Modal, Daytona\n\n## Migration & Compatibility\n\nOpenClaw users can automatically import configurations via `hermes claw migrate`, transferring SOUL.md personas, memories, skills, command allowlists, and API keys.\n\n## Development\n\n**Quick contributor setup:**\n```bash\ngit clone https://github.com/NousResearch/hermes-agent.git\ncd hermes-agent\n./setup-hermes.sh\n```\n\n## Community & Resources\n\n- Discord server for community discussion\n- Skills Hub at agentskills.io for procedural memory sharing\n- GitHub issues for bug reports\n- Comprehensive documentation at hermes-agent.nousresearch.com/docs\n\n## Licensing\n\nMIT License -- Open source and freely distributable.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-hermes-research",
      "to": "page:docs-hermes-research-raw-github-readme",
      "kind": "contains_page"
    }
  ]
}