Quick start
ollama launch hermes
- Install — If Hermes isn’t installed, Ollama prompts to install it via the Nous Research install script
- Model — Pick a model from the selector (local or cloud)
- Onboarding — Ollama configures the Ollama provider, points Hermes at
http://127.0.0.1:11434/v1, and sets your model as the primary - Gateway — Optionally connects a messaging platform (Telegram, Discord, Slack, WhatsApp, Signal, Email) and launches the Hermes chat
Recommended models
Cloud models:kimi-k2.5:cloud— Multimodal reasoning with subagentsglm-5.1:cloud— Reasoning and code generationqwen3.5:cloud— Reasoning, coding, and agentic tool use with visionminimax-m2.7:cloud— Fast, efficient coding and real-world productivity
gemma4— Reasoning and code generation locally (~16 GB VRAM)qwen3.6— Reasoning, coding, and visual understanding locally (~24 GB VRAM)
Connect messaging apps
Link Telegram, Discord, Slack, WhatsApp, Signal, or Email to chat with your models from anywhere:hermes gateway setup
Reconfigure
Re-run the full setup wizard at any time:hermes setup
Manual setup
If you’d rather drive Hermes’s own wizard instead ofollama launch hermes, install it directly:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
How would you like to set up Hermes?
→ Quick setup — provider, model & messaging (recommended)
Full setup — configure everything
Connect to Ollama
- Select More providers...
- Select Custom endpoint (enter URL manually)
-
Set the API base URL to the Ollama OpenAI-compatible endpoint:
API base URL [e.g. https://api.example.com/v1]: http://127.0.0.1:11434/v1 -
Leave the API key blank (not required for local Ollama):
API key [optional]: -
Hermes auto-detects downloaded models, confirm the one you want:
Verified endpoint via http://127.0.0.1:11434/v1/models (1 model(s) visible) Detected model: kimi-k2.5:cloud Use this model? [Y/n]: -
Leave context length blank to auto-detect:
Context length in tokens [leave blank for auto-detect]:
Connect messaging
Optionally connect a messaging platform during setup:Connect a messaging platform? (Telegram, Discord, etc.)
→ Set up messaging now (recommended)
Skip — set up later with 'hermes setup gateway'
Launch
Launch hermes chat now? [Y/n]: Y