hermes-agent-setup

Guide Hermes Agent setup through an interactive CLI configuration wizard.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes Agent setup and configuration is a complex workflow; this skill provides a guided CLI setup, wizard, and configuration management to streamline enabling features, selecting models/providers, and troubleshooting.

Core Features & Use Cases

  • Interactive Setup Wizard: guides provider selection, API keys, model choice, and basic settings.
  • CLI Commands & Paths: explains how to access and modify config (e.g., ~/.hermes/config.yaml, ~/.hermes/.env), manage skills, and operate the gateway.
  • Tools, Skills & Voice Configuration: manage toolsets, STT/TTS, gateway integration, and troubleshooting workflows.
  • Validation & Troubleshooting: includes a doctor-like check to verify dependencies and configurations.

Quick Start

Run hermes setup to begin the interactive configuration wizard for provider, API keys, and model selection.

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 provider and model settings?

To configure Hermes Agent provider and model settings, run the `hermes setup` command to launch an interactive CLI wizard that guides API key entry and model selection. This wizard manages basic settings and persists them directly to your local environment configuration.

Where does the Hermes Agent CLI store configuration files?

The Hermes Agent CLI stores configuration files at `~/.hermes/config.yaml` and `~/.hermes/.env` to persist provider settings, API keys, and model selections. These writable paths manage your local environment setup and gateway integration parameters.

How do I enable voice features and STT/TTS in Hermes Agent?

To enable voice features and STT/TTS in Hermes Agent, use the interactive setup wizard to configure speech-to-text and text-to-speech options. The CLI manages these voice integrations alongside gateway settings within your local config environment.

Can I troubleshoot Hermes Agent configuration errors with a validation check?

You can troubleshoot Hermes Agent configuration errors using a built-in doctor-like validation check. This diagnostic verifies dependencies, validates configurations, and identifies setup issues across your CLI, gateway, and local environment to streamline troubleshooting.

What do I need to set up Hermes Agent locally?

Setting up Hermes Agent locally requires an existing local Hermes installation, access to valid provider API keys, and a writable config environment. These prerequisites ensure the interactive setup wizard can persist settings and activate features successfully.