hermes-agent-setup

Configure Hermes Agent CLI and gateway environments with providers, models, tools, and voice integrations.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/KarlinskyS/hermesSkills --skill hermes-agent-setup-karlinskys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-agent-setup
Source: https://github.com/KarlinskyS/hermesSkills/tree/main/dogfood/hermes-agent-setup
Command: npx skills add https://github.com/KarlinskyS/hermesSkills --skill hermes-agent-setup-karlinskys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes Agent Setup centralizes and simplifies configuring the Hermes CLI and gateway so users can securely add providers, choose models, enable tools and skills, and get voice/STT/TTS working without manual file hunting or guesswork.

Core Features & Use Cases

  • Interactive Setup Wizard: Walks users through provider selection, API key entry, and model selection to create a working agent configuration.
  • Tool and Skill Management: Enables listing, installing, and per-platform enabling/disabling of tools and skills to tailor agent capabilities.
  • Voice/STT and Gateway Configuration: Guides setup for local and cloud STT/TTS providers, environment variable handling, and gateway commands to run messaging integrations.
  • Troubleshooting & Session Management: Includes commands for diagnosing configuration, restarting gateways, managing sessions, and recovering from common issues.
  • Use Case: A developer installing Hermes on a new machine can complete provider login, select preferred models, enable voice transcription, and start the gateway with minimal manual edits.

Quick Start

Run the interactive setup by activating the agent virtual environment and executing the Hermes setup wizard to choose a provider, enter API keys, and select a model.

Frequently Asked Questions about hermes-agent-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Hermes Agent for CLI and gateway environments?

Set up Hermes Agent by activating the agent virtual environment and running the setup wizard to select providers, enter API keys, and choose models. This creates persistent configuration in ~/.hermes with secure env file storage for CLI and gateway use.

What's the best way to set up voice STT and TTS integrations in Hermes?

Use the Hermes setup wizard to configure local and cloud STT/TTS providers, manage environment variables, and run gateway commands. This enables voice transcription and speech output without manual file hunting or guesswork.

Can I manage and enable specific tools and skills per platform in Hermes?

Yes, the Hermes configuration supports listing, installing, and per-platform enabling or disabling of tools and skills. This tailors agent capabilities to specific environments while maintaining a centralized configuration profile.

Does Hermes Agent support secure API key storage for multiple providers?

Yes, Hermes Agent securely stores API keys in environment files within the ~/.hermes directory. The setup wizard handles provider selection and API key entry to create a secure, working agent configuration.

Why is my Hermes gateway not connecting after setup?

Gateway connectivity issues can be diagnosed using Hermes troubleshooting commands for configuration checks, gateway restarts, and session management. These tools help recover from common setup and runtime configuration errors.

Do I need a virtual environment to run the Hermes setup wizard?

Yes, activating the agent virtual environment is required before executing the Hermes setup wizard. This isolates dependencies so the configuration wizard can properly write persistent settings to ~/.hermes.