# nousresearch/hermes-agent

> hermes-agent is an AI agent built by Nous Research for running tasks from a terminal or from chat apps such as Telegram, Discord and Slack. It can use many model providers, creates skills from its own experience, improves those skills during use, and searches past conversations. The project is written mainly in Python, with TypeScript used for its desktop app.

Source: https://github.com/nousresearch/hermes-agent
Indexed: commit 13ce0c5 on 2026-08-19 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 261,697 at index time
- License: MIT
- Code health: 5.3/10, Needs_work
- Last commit: 2026-08-19
- Contributors: 2,790

## Install

From the README: https://github.com/nousresearch/hermes-agent#getting-started

Clone the hermes-agent repository.
    git clone https://github.com/nousresearch/hermes-agent.git

Move into the hermes-agent folder.
    cd hermes-agent

Reload your shell so the new command is on the path.
    source ~/.bashrc # reload shell (or: source ~/.zshrc)

## How to use

Start the interactive CLI and begin a conversation.
    hermes # start chatting!

## How it works

Input enters through the terminal interface started by hermes_cli/main.py, which is also a hotspot file in the hermes_cli package, or through the messaging gateway in gateway/run.py, which runs one process that connects the chat platforms. hermes_state.py is listed as a hotspot file and handles the agent's state. acp_adapter/server.py is an entry point for the ACP adapter that exposes the agent to other clients. The desktop app's Electron main process is in apps/desktop/electron/main.ts. The tests directory is the largest module by file count.

- acp_adapter/__main__.py: entry point
- acp_adapter/entry.py: entry point
- acp_adapter/server.py: entry point
- agent/lsp/cli.py: entry point
- apps/bootstrap-installer/src-tauri/src/bootstrap.rs: entry point
Modules: tests, apps, website, optional-skills, ui-tui, skills, plugins, hermes_cli. 8,758 files, 2,120,703 lines, 100,728 symbols.

## Code health

- Score: 5.3/10 (Needs_work)
- Rank: #211 of 4,000+ indexed repos
- Hotspots: gateway/run.py, hermes_state.py, hermes_cli/web_server.py, apps/desktop/electron/main.ts, hermes_cli/main.py
- Lowest file: gateway/run.py
- Dead code: 382 findings

## Maintenance

- Last commit 2026-08-19, first commit 2025-07-23, 23,858 commits
- 2,790 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/nousresearch/hermes-agent/security

## More

- Page: https://repowise.dev/repo/nousresearch/hermes-agent
- Ask this codebase: https://repowise.dev/repo/nousresearch/hermes-agent/chat
- Docs: https://repowise.dev/repo/nousresearch/hermes-agent/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/nousresearch/hermes-agent