Personal AI assistant setup

SETUP PATH

Get Hermes Agent running as your personal AI assistant.

Start with a clean install, connect a model provider, check that the assistant works, then add the tools and integrations that match your work.

Quick install

Hermes runs on Linux, macOS, and WSL. Open a terminal and run the official installer:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Then start the setup wizard:

hermes setup
hermes doctor
hermes

Useful official links: GitHub repository, documentation, model providers, messaging setup, and MCP integrations.

First working checklist

  1. Install Hermes with the command above.
  2. Run hermes setup and choose a model provider.
  3. Add the provider key or OAuth login when prompted.
  4. Run hermes doctor and fix anything it reports.
  5. Start Hermes with hermes and ask it to do a simple local task.
  6. Enable tools only as you need them: web, browser, file, terminal, memory, cron, messaging, and MCP.

Choose what to set up next

Use the cards below as the next steps after the base install works.