Set Up Hermes Agent with DeepSeek V4

What is Hermes Agent?

Hermes Agent is a free, open-source AI agent framework by Nous Research. Think of it as your own private AI assistant that runs in your terminal, with full access to your files, shell, browser, and tools. It works with any LLM provider — OpenAI, Anthropic, Google, DeepSeek, local models, and 20+ others.

What makes Hermes different from ChatGPT or Claude: it takes action. It can read and edit files, run terminal commands, browse the web, search your past conversations, schedule tasks, and learn from experience by saving reusable procedures as "skills." It works across multiple platforms — terminal, desktop app, Telegram, Discord, Slack, and more.

DeepSeek V4 is a state-of-the-art reasoning model that performs at the level of top-tier models from OpenAI and Anthropic, but at a fraction of the cost. Pairing it with Hermes gives you a powerful, affordable AI agent.

Step 1. Install Hermes Agent

Hermes Agent requires Python 3.10+ and runs on Linux, macOS, and Windows (including WSL). The easiest way to install is with the official shell installer:

This installs uv (a fast Python package manager), creates a virtual environment, and sets up the hermes launcher. Once installed, verify it works:

Step 2. Get a DeepSeek API Key

DeepSeek offers API access at platform.deepseek.com. Sign up, navigate to API Keys, and create a new key. Copy it — you won't see it again.

DeepSeek is dramatically cheaper than OpenAI or Anthropic. A typical day of heavy use costs pennies, not dollars. You can prepay $5 and it'll last weeks for normal usage.

Step 3. Configure the DeepSeek Provider

Hermes stores secrets (API keys) in ~/.hermes/.env and settings in ~/.hermes/config.yaml. Add your DeepSeek key:

Then configure Hermes to use DeepSeek:

That's it! Hermes now uses DeepSeek V4 for all your interactions. You can verify with:

Step 4. Your First Session

Start an interactive session by typing:

You'll see the Hermes prompt. Try something simple like "List the files in my home directory" or "Create a hello.py script that prints Hello World." Hermes will use its tools to read your filesystem and execute commands.

For a single question without entering interactive mode:

Step 5. Key Commands You'll Use

• •hermes — start interactive chat session
• •hermes model — pick or change your model/provider
• •hermes setup — run the setup wizard to configure everything
• •hermes doctor — health check (API keys, connectivity, config)
• •hermes desktop — launch the native desktop app
• •hermes --resume — pick up your most recent session

Step 6. Beyond the Basics

Once you're comfortable, Hermes has deep capabilities:

• •Skills — Hermes learns reusable procedures from experience. After a complex task succeeds, it can save the workflow as a skill for next time.
• •Multi-agent delegation — spawn sub-agents to work on parallel tasks simultaneously.
• •Cron scheduling — set up recurring tasks (daily reports, system checks) that run on schedule.
• •Multiple profiles — run independent Hermes instances with isolated configs, memory, and skills.
• •Gateway — connect Hermes to Telegram, Discord, Slack, and other messaging platforms.

Full documentation: hermes-agent.nousresearch.com/docs