Timmy_Foundation/hermes-agent
15
0
Fork 0
Code Issues 42 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
145f719d309b1ecdde8417c4c6d2d20184817b21
hermes-agent/README.md

122 lines
6.8 KiB
Markdown
Raw Normal View History

feat: update branding and visuals across the project - Updated the README to include a new banner image and changed the title emoji from 🦋 to ⚕. - Modified various CLI outputs and scripts to reflect the new branding, ensuring consistency in the use of the ⚕ emoji. - Added a new banner image asset for enhanced visual appeal during installation and setup processes.
2026-02-20 21:25:04 -08:00
<p align="center">
<img src="assets/banner.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ⚕
Update to use toolsets and make them easy to create and configure
2025-09-10 00:43:55 -07:00
feat: enhance README and update API client initialization - Updated the README to include new badges, a detailed description of the Hermes Agent, and a table summarizing its features, improving clarity and presentation for users. - Modified the API client initialization in `transcription_tools.py` and `tts_tool.py` to include a base URL, ensuring compatibility with the OpenAI API.
2026-02-23 20:59:39 -08:00
<p align="center">
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentation"></a>
Update README.md to replace badge links with new styles and add a link to the X platform for Nous Research
2026-02-25 11:56:12 -08:00
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Built by Nous Research"></a>
feat: enhance README and update API client initialization - Updated the README to include new badges, a detailed description of the Hermes Agent, and a table summarizing its features, improving clarity and presentation for users. - Modified the API client initialization in `transcription_tools.py` and `tts_tool.py` to include a base URL, ensuring compatibility with the OpenAI API.
2026-02-23 20:59:39 -08:00
</p>
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
**The fully open-source AI agent that grows with you.** Install it on a machine, give it your messaging accounts, and it becomes a persistent personal agent — learning your projects, building its own skills, running tasks on a schedule, and reaching you wherever you are.
feat: enhance README and update API client initialization - Updated the README to include new badges, a detailed description of the Hermes Agent, and a table summarizing its features, improving clarity and presentation for users. - Modified the API client initialization in `transcription_tools.py` and `tts_tool.py` to include a base URL, ensuring compatibility with the OpenAI API.
2026-02-23 20:59:39 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
Use any model you want — [Nous Portal](https://portal.nousresearch.com), [OpenRouter](https://openrouter.ai), OpenAI Codex, or your own endpoint. Switch with `hermes model` — no code changes, no lock-in.
feat: enhance README and update API client initialization - Updated the README to include new badges, a detailed description of the Hermes Agent, and a table summarizing its features, improving clarity and presentation for users. - Modified the API client initialization in `transcription_tools.py` and `tts_tool.py` to include a base URL, ensuring compatibility with the OpenAI API.
2026-02-23 20:59:39 -08:00
<table>
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
<tr><td><b>A real terminal interface</b></td><td>Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output.</td></tr>
<tr><td><b>Lives where you do</b></td><td>Telegram, Discord, Slack, WhatsApp, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity.</td></tr>
<tr><td><b>Grows the longer it runs</b></td><td>Persistent memory across sessions. When it solves a hard problem, it writes a skill document for next time. Skills are searchable, shareable, and compatible with the <a href="https://agentskills.io">agentskills.io</a> open standard.</td></tr>
<tr><td><b>Scheduled automations</b></td><td>Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended.</td></tr>
<tr><td><b>Delegates and parallelizes</b></td><td>Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.</td></tr>
docs: add Daytona to backend lists in docs Signed-off-by: rovle <lovre.pesut@gmail.com>
2026-03-05 11:55:41 -08:00
<tr><td><b>Real sandboxing</b></td><td>Six terminal backends — local, Docker, SSH, Singularity, Modal, and Daytona — with persistent workspaces and container security hardening.</td></tr>
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
<tr><td><b>Research-ready</b></td><td>Batch trajectory generation, Atropos RL environments, trajectory compression for training the next generation of tool-calling models.</td></tr>
feat: enhance README and update API client initialization - Updated the README to include new badges, a detailed description of the Hermes Agent, and a table summarizing its features, improving clarity and presentation for users. - Modified the API client initialization in `transcription_tools.py` and `tts_tool.py` to include a base URL, ensuring compatibility with the OpenAI API.
2026-02-23 20:59:39 -08:00
</table>
---
Update to use toolsets and make them easy to create and configure
2025-09-10 00:43:55 -07:00
Enhance CLI with multi-platform messaging integration and configuration management - Updated CLI to load configuration from user-specific and project-specific YAML files, prioritizing user settings. - Introduced a new command `/platforms` to display the status of connected messaging platforms (Telegram, Discord, WhatsApp). - Implemented a gateway system for handling messaging interactions, including session management and delivery routing for cron job outputs. - Added support for environment variable configuration and a dedicated gateway configuration file for advanced settings. - Enhanced documentation in README.md and added a new messaging.md file to guide users on platform integrations and setup. - Updated toolsets to include platform-specific capabilities for Telegram, Discord, and WhatsApp, ensuring secure and tailored interactions.
2026-02-02 19:01:51 -08:00
## Quick Install
Enhance documentation for CLI and tool integration - Updated `.cursorrules` to provide a comprehensive overview of the interactive CLI, including its architecture, key components, and command handling. - Expanded `README.md` to introduce the CLI features, quick start instructions, and detailed command descriptions for user guidance. - Added `docs/cli.md` to document CLI usage, configuration, and animated feedback, ensuring clarity for users and developers. - Revised `docs/tools.md` to include support for SSH backend in terminal tools, enhancing the documentation for terminal execution options.
2026-01-31 06:33:43 +00:00
```bash
Enhance CLI with multi-platform messaging integration and configuration management - Updated CLI to load configuration from user-specific and project-specific YAML files, prioritizing user settings. - Introduced a new command `/platforms` to display the status of connected messaging platforms (Telegram, Discord, WhatsApp). - Implemented a gateway system for handling messaging interactions, including session management and delivery routing for cron job outputs. - Added support for environment variable configuration and a dedicated gateway configuration file for advanced settings. - Enhanced documentation in README.md and added a new messaging.md file to guide users on platform integrations and setup. - Updated toolsets to include platform-specific capabilities for Telegram, Discord, and WhatsApp, ensuring secure and tailored interactions.
2026-02-02 19:01:51 -08:00
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Enhance documentation for CLI and tool integration - Updated `.cursorrules` to provide a comprehensive overview of the interactive CLI, including its architecture, key components, and command handling. - Expanded `README.md` to introduce the CLI features, quick start instructions, and detailed command descriptions for user guidance. - Added `docs/cli.md` to document CLI usage, configuration, and animated feedback, ensuring clarity for users and developers. - Revised `docs/tools.md` to include support for SSH backend in terminal tools, enhancing the documentation for terminal execution options.
2026-01-31 06:33:43 +00:00
```
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
Works on Linux, macOS, and WSL2. The installer handles everything — Python, Node.js, dependencies, and the `hermes` command. No prerequisites except git.
feat: Windows native support via Git Bash - Add scripts/install.cmd batch wrapper for CMD users (delegates to install.ps1) - Add _find_shell() in local.py: detects Git Bash on Windows via HERMES_GIT_BASH_PATH env var, shutil.which, or common install paths (same pattern as Claude Code's CLAUDE_CODE_GIT_BASH_PATH) - Use _find_shell() in process_registry.py for background processes - Fix hermes_cli/gateway.py: use wmic instead of ps aux on Windows, skip SIGKILL (doesn't exist on Windows), fix venv path (Scripts/python.exe vs bin/python) - Update README with three install commands (Linux/macOS, PowerShell, CMD) and Windows native documentation Requires Git for Windows, which bundles bash.exe. The terminal tool transparently uses Git Bash for shell commands regardless of whether the user launched hermes from PowerShell or CMD.
2026-03-02 22:03:29 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
> **Windows:** Native Windows is not supported. Please install [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) and run the command above.
feat: Windows native support via Git Bash - Add scripts/install.cmd batch wrapper for CMD users (delegates to install.ps1) - Add _find_shell() in local.py: detects Git Bash on Windows via HERMES_GIT_BASH_PATH env var, shutil.which, or common install paths (same pattern as Claude Code's CLAUDE_CODE_GIT_BASH_PATH) - Use _find_shell() in process_registry.py for background processes - Fix hermes_cli/gateway.py: use wmic instead of ps aux on Windows, skip SIGKILL (doesn't exist on Windows), fix venv path (Scripts/python.exe vs bin/python) - Update README with three install commands (Linux/macOS, PowerShell, CMD) and Windows native documentation Requires Git for Windows, which bundles bash.exe. The terminal tool transparently uses Git Bash for shell commands regardless of whether the user launched hermes from PowerShell or CMD.
2026-03-02 22:03:29 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
After installation:
Add environment configuration file, restructure tool imports, and enhance README setup instructions
2025-10-01 09:54:17 +00:00
Update environment configuration and enhance terminal tool integration - Updated `.env.example` to include new API keys and configuration options for the mini-swe-agent backend, including support for local, Docker, and Modal environments. - Added `.gitmodules` to include mini-swe-agent as a submodule for easier integration. - Refactored `mini_swe_runner.py` to use the updated model format and default to OpenRouter for API calls. - Enhanced `model_tools.py` to support the new terminal tool definitions and ensure compatibility with the mini-swe-agent backend. - Updated `README.md` to reflect changes in setup instructions and environment variable configurations. - Improved `terminal_tool.py` to manage execution environments and lifecycle, ensuring proper cleanup and error handling. - Introduced `terminal_hecate.py` for executing commands on MorphCloud VMs, providing an alternative backend for terminal operations.
2026-01-23 12:26:53 +00:00
```bash
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes setup # configure your LLM provider
hermes # start chatting!
Update environment configuration and enhance terminal tool integration - Updated `.env.example` to include new API keys and configuration options for the mini-swe-agent backend, including support for local, Docker, and Modal environments. - Added `.gitmodules` to include mini-swe-agent as a submodule for easier integration. - Refactored `mini_swe_runner.py` to use the updated model format and default to OpenRouter for API calls. - Enhanced `model_tools.py` to support the new terminal tool definitions and ensure compatibility with the mini-swe-agent backend. - Updated `README.md` to reflect changes in setup instructions and environment variable configurations. - Improved `terminal_tool.py` to manage execution environments and lifecycle, ensuring proper cleanup and error handling. - Introduced `terminal_hecate.py` for executing commands on MorphCloud VMs, providing an alternative backend for terminal operations.
2026-01-23 12:26:53 +00:00
```
Enhance CLI with multi-platform messaging integration and configuration management - Updated CLI to load configuration from user-specific and project-specific YAML files, prioritizing user settings. - Introduced a new command `/platforms` to display the status of connected messaging platforms (Telegram, Discord, WhatsApp). - Implemented a gateway system for handling messaging interactions, including session management and delivery routing for cron job outputs. - Added support for environment variable configuration and a dedicated gateway configuration file for advanced settings. - Enhanced documentation in README.md and added a new messaging.md file to guide users on platform integrations and setup. - Updated toolsets to include platform-specific capabilities for Telegram, Discord, and WhatsApp, ensuring secure and tailored interactions.
2026-02-02 19:01:51 -08:00
---
Add environment configuration file, restructure tool imports, and enhance README setup instructions
2025-10-01 09:54:17 +00:00
feat: enhance README and CLI with multi-provider model selection - Added a comprehensive "Getting Started" section in the README to guide users through selecting inference providers. - Implemented an interactive model selection feature in the CLI, allowing users to choose from available models or enter a custom model name. - Improved user experience by displaying the current model and active provider during selection, with clear instructions for each provider type. - Updated the model selection process to prioritize the currently active model, enhancing usability and clarity.
2026-02-20 17:52:46 -08:00
## Getting Started
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
```bash
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
hermes # Interactive CLI — start a conversation
hermes model # Switch provider or model
hermes setup # Re-run the setup wizard
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
```
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
📖 **[Full documentation →](https://hermes-agent.nousresearch.com/docs/)**
feat: enhance README and improve environment configuration - Added a new section in the README for Inference Providers, detailing setup instructions for Nous Portal, OpenRouter, and Custom Endpoints, improving user guidance for LLM connections. - Updated messaging platform setup instructions to include Slack and WhatsApp, providing clearer steps for configuration. - Introduced a new environment variable, TERMINAL_SANDBOX_DIR, to allow users to customize the sandbox storage location for Docker and Singularity environments. - Refactored the Docker and Singularity environment classes to utilize the new sandbox directory for persistent workspaces, enhancing organization and usability. - Improved handling of working directories across various environments, ensuring compatibility and clarity in execution paths.
2026-02-23 21:15:35 -08:00
---
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
## Documentation
Update environment configuration and enhance terminal tool integration - Updated `.env.example` to include new API keys and configuration options for the mini-swe-agent backend, including support for local, Docker, and Modal environments. - Added `.gitmodules` to include mini-swe-agent as a submodule for easier integration. - Refactored `mini_swe_runner.py` to use the updated model format and default to OpenRouter for API calls. - Enhanced `model_tools.py` to support the new terminal tool definitions and ensure compatibility with the mini-swe-agent backend. - Updated `README.md` to reflect changes in setup instructions and environment variable configurations. - Improved `terminal_tool.py` to manage execution environments and lifecycle, ensuring proper cleanup and error handling. - Introduced `terminal_hecate.py` for executing commands on MorphCloud VMs, providing an alternative backend for terminal operations.
2026-01-23 12:26:53 +00:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
All documentation lives at **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
feat(provider-routing): add OpenRouter provider routing configuration Introduced a new `provider_routing` section in the CLI configuration to control how requests are routed across providers when using OpenRouter. This includes options for sorting providers by throughput, latency, or price, as well as allowing or ignoring specific providers, setting the order of provider attempts, and managing data collection policies. Updated relevant classes and documentation to support these features, enhancing flexibility in provider selection.
2026-03-01 18:24:27 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
| Section | What's Covered |
|---------|---------------|
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Install → setup → first conversation in 2 minutes |
| [CLI Usage](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Commands, keybindings, personalities, sessions |
| [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Config file, providers, models, all options |
| [Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Home Assistant |
| [Security](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Command approval, DM pairing, container isolation |
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40+ tools, toolset system, terminal backends |
| [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Procedural memory, Skills Hub, creating skills |
| [Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Persistent memory, user profiles, best practices |
| [MCP Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Connect any MCP server for extended capabilities |
| [Cron Scheduling](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Scheduled tasks with platform delivery |
| [Context Files](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Project context that shapes every conversation |
| [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Project structure, agent loop, key classes |
| [Contributing](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Development setup, PR process, code style |
| [CLI Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | All commands and flags |
| [Environment Variables](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Complete env var reference |
feat(provider-routing): add OpenRouter provider routing configuration Introduced a new `provider_routing` section in the CLI configuration to control how requests are routed across providers when using OpenRouter. This includes options for sorting providers by throughput, latency, or price, as well as allowing or ignoring specific providers, setting the order of provider attempts, and managing data collection policies. Updated relevant classes and documentation to support these features, enhancing flexibility in provider selection.
2026-03-01 18:24:27 -08:00
Enhance CLI with multi-platform messaging integration and configuration management - Updated CLI to load configuration from user-specific and project-specific YAML files, prioritizing user settings. - Introduced a new command `/platforms` to display the status of connected messaging platforms (Telegram, Discord, WhatsApp). - Implemented a gateway system for handling messaging interactions, including session management and delivery routing for cron job outputs. - Added support for environment variable configuration and a dedicated gateway configuration file for advanced settings. - Enhanced documentation in README.md and added a new messaging.md file to guide users on platform integrations and setup. - Updated toolsets to include platform-specific capabilities for Telegram, Discord, and WhatsApp, ensuring secure and tailored interactions.
2026-02-02 19:01:51 -08:00
---
Update environment configuration and enhance tool definitions - Modified `.env.example` to set default terminal environment to 'local' and updated Docker, Singularity, and Modal image references to use 'python:3.11-slim'. - Updated `package.json` to include Node.js engine requirements and modified post-install script for better user guidance. - Enhanced `pyproject.toml` to reflect new dependencies and optional dependencies for modal and development environments. - Improved `README.md` with additional setup instructions for Singularity and Node.js dependencies, along with clearer toolset documentation. - Refactored `model_tools.py` to include new tool definitions and ensure consistency across toolsets. - Updated architecture documentation to clarify tool structure and registration processes.
2026-01-29 22:36:07 +00:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
## Contributing
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
We welcome contributions! See the [Contributing Guide](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) for development setup, code style, and PR process.
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
Quick start for contributors:
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
```bash
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
uv pip install -e "./mini-swe-agent"
python -m pytest tests/ -q
feat: expand README with update and messaging gateway instructions - Added detailed sections for updating the Hermes agent, including quick and manual update methods. - Introduced a messaging gateway section with setup instructions for Telegram, Discord, and Slack, along with commands for managing the gateway. - Included security recommendations and context file usage to enhance user guidance.
2026-02-19 02:10:02 -08:00
```
---
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
## Community
refactor: streamline cron job handling and update CLI commands - Removed legacy cron daemon functionality, integrating cron job execution directly into the gateway process for improved efficiency. - Updated CLI commands to reflect changes, replacing `hermes cron daemon` with `hermes cron status` and enhancing documentation for cron job management. - Clarified messaging in the README and other documentation regarding the gateway's role in managing cron jobs. - Removed obsolete terminal_hecate tool and related configurations to simplify the codebase.
2026-02-21 16:21:19 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 💡 [Discussions](https://github.com/NousResearch/hermes-agent/discussions)
feat: enhance interrupt handling and container resource configuration - Introduced a shared interrupt signaling mechanism to allow tools to check for user interrupts during long-running operations. - Updated the AIAgent to handle interrupts more effectively, ensuring in-progress tool calls are canceled and multiple interrupt messages are combined into one prompt. - Enhanced the CLI configuration to include container resource limits (CPU, memory, disk) and persistence options for Docker, Singularity, and Modal environments. - Improved documentation to clarify interrupt behaviors and container resource settings, providing users with better guidance on configuration and usage.
2026-02-23 02:11:33 -08:00
Enhance CLI with multi-platform messaging integration and configuration management - Updated CLI to load configuration from user-specific and project-specific YAML files, prioritizing user settings. - Introduced a new command `/platforms` to display the status of connected messaging platforms (Telegram, Discord, WhatsApp). - Implemented a gateway system for handling messaging interactions, including session management and delivery routing for cron job outputs. - Added support for environment variable configuration and a dedicated gateway configuration file for advanced settings. - Enhanced documentation in README.md and added a new messaging.md file to guide users on platform integrations and setup. - Updated toolsets to include platform-specific capabilities for Telegram, Discord, and WhatsApp, ensuring secure and tailored interactions.
2026-02-02 19:01:51 -08:00
---
Update environment configuration and enhance terminal tool integration - Updated `.env.example` to include new API keys and configuration options for the mini-swe-agent backend, including support for local, Docker, and Modal environments. - Added `.gitmodules` to include mini-swe-agent as a submodule for easier integration. - Refactored `mini_swe_runner.py` to use the updated model format and default to OpenRouter for API calls. - Enhanced `model_tools.py` to support the new terminal tool definitions and ensure compatibility with the mini-swe-agent backend. - Updated `README.md` to reflect changes in setup instructions and environment variable configurations. - Improved `terminal_tool.py` to manage execution environments and lifecycle, ensuring proper cleanup and error handling. - Introduced `terminal_hecate.py` for executing commands on MorphCloud VMs, providing an alternative backend for terminal operations.
2026-01-23 12:26:53 +00:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
## License
Add Text-to-Speech (TTS) functionality with multiple providers Add tool previews Add AGENTS and SOUL.md support Add Exec Approval
2026-02-12 10:05:08 -08:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
MIT — see [LICENSE](LICENSE).
Add ephemeral system prompt support in batch and agent runners. Update README with usage examples and documentation for the new feature. Ensure prompt is not saved to trajectories.
2025-10-08 02:33:58 +00:00
docs: simplify README from 1776 to 121 lines All detailed documentation now lives at hermes-agent.nousresearch.com/docs/. README retains: banner, badges, value proposition, feature highlights, one-line install, getting started commands, docs site link table, quick contributor setup, community links, and license. Removed: 1600+ lines of inline docs covering config, messaging setup, tools, skills, MCP, terminal backends, memory, cron, hooks, security, TTS, browser, batch processing, RL training, manual installation, env vars reference, file structure, and troubleshooting.
2026-03-05 07:33:07 -08:00
Built by [Nous Research](https://nousresearch.com).
Reference in New Issue Copy Permalink