AI Agent

Free

This is your free AI agent that we want you to set up and have!! If you have any questions feel free to ask and we can help you set it up.

Easy Windows installation

1. Open the official Hermes website

Go here:

https://hermes-agent.nousresearch.com/desktop

Click the Windows download button.

Download the file ending in:

.appinstaller

Do not download random Hermes files from third-party websites.

2. Install Hermes

When the download finishes:

Open your Downloads folder.

Double-click the .appinstaller file.

Windows App Installer will open.

Click Install.

Wait for the installation to finish.

The normal desktop package already includes the required runtime and dependencies.

3. Open Hermes

After installation:

Press the Windows key.

Type Hermes.

Click the Hermes app.

You can right-click it and choose Pin to Start or Pin to taskbar.

4. Complete the first-time setup

When Hermes opens, choose the setup option presented on screen.

For the easiest setup, choose:

Quick Setup — Nous Portal

This is the simplest route because it can provide the model connection and supported tools through one login instead of making you configure several separate API keys.

A browser window will open. Sign in or create your Nous Portal account, approve the authorization, and return to Hermes.

Never send your password, API key, credit card number, or login code to me in chat.

5. Choose your model

During setup, Hermes will ask which model you want.

For now:

Choose the recommended/default model.

Leave the other settings at their defaults.

Continue until setup says it is complete.

You can change models later from Hermes settings.

6. Test that Hermes works

In the Hermes chat window, type:

Hello. Confirm that you are installed and working.

Click Send.

A successful installation means Hermes responds normally without showing a provider, authentication, or configuration error.

Then test its computer access with:

Tell me the name of the current folder you are working in.

If it answers that, the installation and basic tools are working.

7. If you already have another AI provider

You do not have to use Nous Portal. Hermes also supports providers such as:

OpenAI/Codex

Anthropic/Claude

OpenRouter

Google/Gemini

DeepSeek

xAI/Grok

GitHub Copilot

Local models through Ollama or LM Studio

During setup, choose Full Setup instead of Quick Setup, then select your provider and follow the provider’s login or API-key screen.

For the least complicated first installation, use Quick Setup first. You can switch providers later.

8. Optional: make Hermes start with Windows

After Hermes is working:

Open Hermes.

Go to Settings.

Look for Startup, Gateway, or Run at login.

Enable the option if you want Hermes available automatically after you sign into Windows.

Do not enable this until the normal chat test in Step 6 works.

Important note about the computer being asleep

The desktop installation runs on your Windows computer. If the computer is shut down or asleep, Hermes cannot perform tasks from that computer.

To use Hermes from your phone while your computer is off, you would need to run the Hermes backend on an always-on computer or cloud server and then connect a messaging service such as Telegram. That is a separate setup from installing the desktop app.

If the website download does not work

The Windows desktop package requires a reasonably current version of Windows 11. If Windows refuses to open the .appinstaller file, use the official fallback installer documented here:

https://hermes-agent.nousresearch.com/docs/user-guide/windows-native