hermes-install

one-command installer and setup wizard for hermes agent.

npm install -g @gwardo420/hermes-install

what is this

hermes-install handles the entire setup flow for Hermes Agent:

• install — clones repo, creates venv, installs deps, creates launcher
• setup — interactive wizard for providers, API keys, toolsets, gateway
• doctor — health check and diagnostics
• providers — manage 12+ LLM provider API keys
• mcp — manage MCP servers with presets
• profiles — create, clone, switch profiles
• gateway — configure Telegram, Discord, Slack, etc.
• env — manage .env variables directly

no more copy-pasting curl commands, editing yaml by hand, or googling "where do i get an openrouter api key".

quick start

# install hermes
npm install -g @gwardo420/hermes-install
hermes-install install

# run the setup wizard
hermes-install setup

# or do it all at once
hermes-install install && hermes-install setup

commands

| command | description | |---------|-------------| | hermes-install install | install hermes agent | | hermes-install setup | interactive setup wizard | | hermes-install doctor | health check | | hermes-install config view | show config.yaml | | hermes-install config edit | open in $EDITOR | | hermes-install config set KEY V | set config value | | hermes-install config list | list all config (masked) | | hermes-install providers list | show configured providers | | hermes-install providers add | add an API provider | | hermes-install providers test | validate API keys | | hermes-install mcp list | show MCP servers | | hermes-install mcp add | add from presets | | hermes-install mcp presets | show available presets | | hermes-install profiles list | list profiles | | hermes-install profiles create NAME | create a profile | | hermes-install profiles use NAME | switch profile | | hermes-install gateway status | check gateway | | hermes-install gateway setup | configure platform | | hermes-install env list | list .env variables | | hermes-install env set KEY V | set .env variable | | hermes-install update | update hermes + this tool |

providers

supported providers (with one-command setup):

| provider | key | models | |----------|-----|--------| | OpenRouter | OPENROUTER_API_KEY | 100+ models | | Anthropic | ANTHROPIC_API_KEY | claude-sonnet-4, opus | | OpenAI | OPENAI_API_KEY | gpt-4o, gpt-4-turbo | | DeepSeek | DEEPSEEK_API_KEY | deepseek-v3, r1 | | Groq | GROQ_API_KEY | llama-3, mixtral | | Cerebras | CEREBRAS_API_KEY | llama-3 | | Together AI | TOGETHER_API_KEY | open source models | | Mistral | MISTRAL_API_KEY | mistral-large | | Hugging Face | HF_TOKEN | model hub | | MiniMax | MINIMAX_API_KEY | MiniMax-M2.7 | | Kimi/Moonshot | KIMI_API_KEY | moonshot-v1 | | Z.AI/GLM | GLM_API_KEY | glm-4 |

mcp presets

pre-configured MCP servers:

| server | description | |--------|-------------| | GitHub | repo management, issues, PRs | | Filesystem | file ops with access control | | Brave Search | web search | | Puppeteer | browser automation | | PostgreSQL | database queries | | Memory | knowledge graph |

gateway platforms

supported messaging platforms:

• Telegram — most popular, bot via @BotFather
• Discord — bot with full tool access
• Slack — workplace integration
• WhatsApp — via whatsapp-web.js
• Signal — signal-cli bridge
• Matrix — decentralized
• Home Assistant — smart home

how it works

hermes-install install
    ├── check python, git, node
    ├── clone hermes-agent repo
    ├── create .venv + install deps
    ├── create launcher script
    └── add to PATH

hermes-install setup
    ├── choose provider
    ├── enter API keys
    ├── configure toolsets
    ├── set up gateway (optional)
    └── write config.yaml + .env

all config lives in ~/.hermes/:

~/.hermes/
├── config.yaml      # hermes settings
├── .env             # API keys (chmod 600)
├── skills/          # installed skills
├── sessions/        # conversation history
├── logs/            # gateway + error logs
└── auth.json        # OAuth tokens

doctor

run a health check anytime:

hermes-install doctor

checks:

• python version (3.10+)
• git installed
• hermes in PATH
• config files exist
• API keys configured
• gateway status

requirements

• node.js >= 18
• python >= 3.10
• git

related

• hermes-agent — the agent itself
• hermes docs — full documentation
• envvault — encrypted env vars for teams

license

MIT