hermes-agent
NousResearch/hermes-agent · Updated
The agent that grows with you
NousResearch/hermes-agent is a Python repository in the AI Agents category with 257,929 stars and 56,577 forks on GitHub, released under the MIT license, last updated today.
How to install hermes-agent in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install hermes-agent in Claude CodeAnthropic's agentic CLI
Clone & open
bashgit clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent claudeLet Claude read it
Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.
How to install hermes-agent in Claude DesktopDesktop app (MCP config)
Clone the repository
bashgit clone https://github.com/NousResearch/hermes-agent.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install hermes-agent in CursorAI-first code editor
Clone & open in Cursor
bashgit clone https://github.com/NousResearch/hermes-agent.gitIndex & chat
Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.
How to install hermes-agent in Codex CLIOpenAI coding agent
Clone
bashgit clone https://github.com/NousResearch/hermes-agent.gitPoint Codex at it
Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.
How to install hermes-agent in WindsurfCodeium's agentic IDE
Clone & open
bashgit clone https://github.com/NousResearch/hermes-agent.gitUse Cascade
Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.
How to install hermes-agent in ClineVS Code autonomous agent
Clone the repository
bashgit clone https://github.com/NousResearch/hermes-agent.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install hermes-agent in VS CodeCopilot / MCP support
Clone the repository
bashgit clone https://github.com/NousResearch/hermes-agent.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
Documentation
Full READMEHermes Agent ☤
Hermes Agent | Hermes Desktop
The self-improving AI agent built by [Nous Research](https://nousresearch.com). It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions. Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle. It's not tied to your laptop — talk to it from Telegram while it works on a cloud VM.
Use any model you want — Nous Portal, OpenRouter, OpenAI, your own endpoint, and many others. Switch with hermes model — no code changes, no lock-in.
<b>A real terminal interface</b>Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output. <b>Lives where you do</b>Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity. <b>A closed learning loop</b>Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. Honcho dialectic user modeling. Compatible with the agentskills.io open standard. <b>Scheduled automations</b>Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended. <b>Delegates and parallelizes</b>Spawn isolated subagents for parallel workstreams. In Desktop, choose their provider, model, and limits under Settings → Model → Subagents, then Apply the complete route. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns. <b>Runs anywhere, not just your laptop</b>Six built-in terminal backends — local, Docker, SSH, Modal, Daytona, and Vercel Sandbox — plus plugin backends such as Singularity/Apptainer. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster. <b>Research-ready</b>Batch trajectory generation, trajectory compression for training the next generation of tool-calling models.
Quick Install
Linux, macOS, WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashWindows (native, PowerShell)
Heads up: Native Windows runs Hermes without WSL — CLI, gateway, TUI, and tools all work natively. If you'd rather use WSL2, the Linux/macOS one-liner above works there too. Found a bug? Please file issues.
Run this in PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)The source installer delegates Python 3.14, Node.js, npm, ripgrep, FFmpeg, and Python dependencies to PM. If Git is absent, it stages the verified Git for Windows archive in Hermes' tool store. It does not replace your system Git. See installation methods for the separate MSIX/App Installer package and its update ownership.
Excerpt — the full document is on GitHub.
More AI Agents repositories
- AI Agents264k
deepseek-harness
DeepSeek Harness: Everything is a Plugin.
TypeScriptMITdeepseek-ai/deepseek-harness
- AI Agents196k
firecrawl
Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScriptAGPL-3.0firecrawl/firecrawl
- AI Agents179k
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
JavaScriptMITDietrichGebert/ponytail
- AI Agents149k
langchain
The agent engineering platform.
PythonMITlangchain-ai/langchain
- AI Agents109k
orca
Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScriptMITstablyai/orca
- AI Agents109k
gemini-cli
An open-source AI agent that brings the power of Gemini directly into your terminal.
TypeScriptApache-2.0google-gemini/gemini-cli
Catalog data refreshed . Something wrong? Report it.