Skip to main content

Hermes Agent Setup Guide

Overview

This document describes the complete installation and configuration process for Hermes Agent using a custom OpenAI-compatible API endpoint.

1. Installation

Windows (PowerShell)

Open PowerShell and run:

macOS / Linux

Install Hermes Agent using the official install script:
After installation, reload your shell and verify:
The installer will:
  • Install Hermes Agent
  • Install required dependencies
  • Create configuration files
  • Add Hermes to PATH
  • Launch the setup wizard
Setting up Hermes

2. Setup Wizard

Setup Type

Prompt:
Selected:
Reason:
  • Using a custom API gateway
  • Managing own API keys
  • Full control over provider configuration

3. Model Provider

Prompt:
Selected:

4. Endpoint Configuration

Base URL

Configured:

API Compatibility Mode

Prompt:
Selected:
Reason:
  • OpenAI-compatible endpoint
  • Uses /chat/completions

5. Model Selection

Hermes successfully queried the gateway and discovered available models. Example models returned:
Selected model:
Recommended options:

General Purpose

Coding

Dynamic Routing


6. Context Length

Prompt:
Selected:
Reason:
  • Allow Hermes to auto-detect model limits

7. Provider Display Name

Prompt:
Configured:
(or any preferred name)
Hermes Configuration

8. Terminal Backend

Prompt:
Selected:
Reason:
  • Direct access to local repositories
  • Direct access to Node.js, Python, Git
  • Best experience for software development

9. Messaging Platforms

Prompt:
Selected:
Action:
Reason:
  • Focus on local coding workflow
  • Configure Telegram/Discord/etc. later if needed

10. Tool Configuration

Enabled:
Disabled:

11. Browser Automation Provider

Prompt:
Selected:
Reason:
  • Free
  • No API key required
  • Local Chromium execution

12. Image Generation Provider

Prompt:
Selected:
Reason:
  • Not required for coding workflows
  • Can be configured later

13. Text-to-Speech Provider

Prompt:
Selected:
Reason:
  • Free
  • Local
  • No API key required

14. Web Search Provider

Prompt:
Selected:
Reason:
  • Free
  • No API key required
  • Good enough for general research

15. Installation Result

Successful installation message:
Files created:
Important files:

16. Common Commands

Start Hermes

Hermes Terminal

Re-run Setup

Change Model

Configure Tools

Configure Terminal Backend

Show Current Configuration

Edit Configuration

Run Diagnostics

Update Hermes


17. Configuration Location

Config

Environment Variables


18. Validation Steps

After installation:
Verify:
If all commands succeed, the installation is complete and functional.