other / agent
Hermes Agent
An AI agent with a terminal interface and a messaging gateway for Telegram, Discord, Slack, WhatsApp and Signal, plus memory, skills and scheduled tasks.
At a glance
- Purpose
- An AI agent with a terminal interface and a messaging gateway for Telegram, Discord, Slack, WhatsApp and Signal, plus memory, skills and scheduled tasks.
- Runs in
- Local agent with shell
- Operating systems
- macOS, Linux, Windows
- Needs
- Runtime: Python 3.14, Node.js, npm, ripgrep, FFmpeg; Needs internet: Yes; Needs accounts or API keys beyond your agent: Not stated
- Files and data
- Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
- Tool type
- Agent
- Delivery
- From GitHub
- Version
- Latest on the main branch
- Access
- Code on GitHub
- Compatibility
- According to the README, Hermes Agent installs on Linux, macOS, WSL2 and native Windows, and on Android through Termux on aarch64 devices. It names Nous Portal, OpenRouter, OpenAI and your own endpoint as model options. It names Telegram, Discord, Slack, WhatsApp, Signal and Email as messaging platforms, and its documentation table also lists Home Assistant. The README names local, Docker, SSH, Singularity, Modal, Daytona and Vercel Sandbox as terminal backends. The README also mentions MCP servers and importing from OpenClaw.
- External costs
- The README says Hermes works with the model provider you choose and names Nous Portal, OpenRouter, OpenAI and your own endpoint. It describes Nous Portal as one subscription that covers models, web search, image generation, text-to-speech and a cloud browser, and says you can still bring your own keys per tool. The README states no price for Nous Portal. These services may charge for usage.
- Permissions
- The README's shell/PowerShell routes execute remote installers. The README says Windows installs under %LOCALAPPDATA%\hermes and WSL2 under ~/.hermes, installing Python, Node.js, npm, ripgrep, FFmpeg and Python dependencies. The README also offers an antivirus folder exclusion. The README describes configurable tools, local/remote terminals, subagents, unattended scheduled tasks delivering to messaging platforms and MCP. The README says hermes setup --portal uses OAuth, selects Nous and enables a Tool Gateway for web search, image generation, text-to-speech and a cloud browser; per-tool API keys are another option. The README says OpenClaw migration reads ~/.openclaw and imports settings, memories, skills, command allowlists, messaging settings, allowlisted API keys, audio and workspace instructions. The README offers a user-data migration preset that excludes secrets, a --dry-run preview and --overwrite to overwrite existing conflicts.
- Usage terms
- MIT License, as stated in the repository. See its LICENSE file for the exact terms.
Code on GitHub
NousResearch/hermes-agent
MITThe agent that grows with you
Topics: ai ai-agent ai-agents anthropic chatgpt claude claude-code codex
Public GitHub data fetched · 0 days old
View on GitHub ↗What it does
Hermes Agent is an AI agent built by Nous Research, according to the README. The README describes a terminal interface with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect and streaming tool output. The README says a gateway connects Telegram, Discord, Slack, WhatsApp, Signal and the CLI.The README describes memory with periodic nudges, skill creation after complex tasks, skill improvement during use and FTS5 session search with LLM summarization. The README also describes scheduled tasks with platform delivery, isolated subagents and terminal backends named local, Docker, SSH, Singularity, Modal, Daytona and Vercel Sandbox.
The README names Nous Portal, OpenRouter, OpenAI and user-supplied endpoints as model options, selected with hermes model, and describes migration of OpenClaw settings, memories, skills and API keys.
Who it is for
People who want an AI agent they can use from a terminal or through messaging apps, with memory, skills and scheduled tasks.Example tasks
Install Hermes Agent and start a conversation with hermes.Choose a model provider and model with hermes model.
Set up the messaging gateway and talk to the agent from Telegram or Discord.
Schedule a recurring task, such as a daily report, in natural language.
Migrate settings, memories and skills from an OpenClaw install.
Getting started
The README gives a shell install script for Linux, macOS and WSL2 and a PowerShell command for native Windows. For Android on aarch64 devices it points to a Termux guide.After installation, the README says to reload your shell with source ~/.bashrc or source ~/.zshrc, then run:
hermes
The README lists these commands: hermes model chooses your LLM provider and model, hermes tools configures which tools are enabled, hermes setup runs the full setup wizard, hermes update updates to the latest version and hermes doctor diagnoses issues.
To use Nous Portal for models and tools, the README gives:
hermes setup --portal
The README has the exact commands.
Limitations
The README says you choose your LLM provider and model with hermes model. For the messaging platforms, it says to set up and start the gateway and then send the bot a message.The install route depends on your system. The README gives a shell script for Linux, macOS and WSL2 and a PowerShell command for native Windows, and it says native Windows runs Hermes without WSL. For Android on aarch64 devices, it points to a Termux guide and says not to use the desktop or server installer script.
The repository can change at any time; check its README before you install.
Data practices
The README has no dedicated data-handling or telemetry section. The README describes persistent memory, conversation history, FTS5 session search with LLM summarization and Honcho user modeling, without detailing Honcho's data flow. What is sent where depends on the configured providers and tools.The README says the Nous Portal Tool Gateway routes web search, image generation, text-to-speech and cloud-browser requests through a subscription, naming FAL, OpenAI and Browser Use for the latter services. The README also describes importing OpenClaw memories, messaging settings and allowlisted API keys, with a user-data migration preset that excludes secrets.