> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Run Nous Research Hermes Agent on an Orgo cloud computer

<img src="https://mintcdn.com/orgo/wJayerraXQVuhJ4i/images/hermes-agent.png?fit=max&auto=format&n=wJayerraXQVuhJ4i&q=85&s=5f67a5ca72b50b724fc9659beac69a2f" alt="Hermes Agent" className="rounded-md" noZoom width="1145" height="196" data-path="images/hermes-agent.png" />

[Hermes Agent](https://hermes-agent.nousresearch.com/) is Nous Research's self-improving AI agent. It builds skills from experience, refines them during use, and maintains a persistent model of the user across sessions. This guide installs Hermes inside an Orgo cloud computer.

## Why run Hermes on an Orgo computer

|                                     | Local laptop                                                  | Orgo cloud computer                                        |
| ----------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------- |
| Uptime                              | Off when the laptop sleeps                                    | Continuous                                                 |
| Reachable from other devices        | Same network only                                             | Anywhere                                                   |
| Persistent state and learned skills | Tied to one machine                                           | Lives in `~/.hermes/` on the computer                      |
| Setup per device                    | Reinstall each time                                           | One install, one config                                    |
| Isolation                           | Full access to your personal files, accounts, and credentials | Isolated VM. Only the files and credentials you put on it. |

The agent, its tools, gateway, and learned skills live on the cloud computer. Other devices connect to it.

### Isolation

Hermes is designed to take actions on a computer: install packages, edit files, run shell commands, hit APIs with your credentials. On a personal laptop that means the agent has the same access you do, including your home directory, browser sessions, SSH keys, and `~/.aws/credentials`. On an Orgo computer the blast radius is the VM. The agent has access to whatever you install or paste into that VM and nothing else. Delete the computer and the state is gone.

## Install

<Steps>
  <Step title="Create the computer">
    Open [orgo.ai/workspaces](https://orgo.ai/workspaces) and create a computer with at least **8 GB RAM** and **4 CPU cores**. The installer pulls Python, Node.js, ripgrep, and ffmpeg.
  </Step>

  <Step title="Open a terminal on the computer">
    Open the computer in the dashboard and launch **Terminal** from the taskbar.
  </Step>

  <Step title="Run the installer">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    The installer handles everything in one shot:

    * Installs Python 3.11+, Node.js 22, ripgrep, ffmpeg, and `uv` if missing.
    * Clones the repo and sets up a virtual environment.
    * Registers the global `hermes` command on `$PATH`.
    * Walks through picking an LLM provider and pasting an API key.

    Reload the shell to pick up the new command:

    ```bash theme={null}
    source ~/.bashrc
    ```
  </Step>

  <Step title="Run the setup wizard">
    ```bash theme={null}
    hermes setup
    ```

    For Nous Portal accounts:

    ```bash theme={null}
    hermes setup --portal
    ```
  </Step>

  <Step title="Start chatting">
    ```bash theme={null}
    hermes
    ```

    Quit with `Ctrl+D`. Hermes persists everything it learns to `~/.hermes/`.
  </Step>
</Steps>

## Install via the Orgo SDK

```python theme={null}
from orgo import Computer

computer = Computer(workspace="hermes", ram=8, cpu=4)

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

print(computer.bash("source ~/.bashrc && hermes --version"))
```

Configure model and tools by SSHing in and running `hermes setup`, or by templating `~/.hermes/config.toml` ahead of time.

## Messaging gateways

Hermes can accept messages from Slack, Discord, Telegram, email, and more:

```bash theme={null}
hermes gateway setup
```

A computer has no public inbound hostname — run gateways in outbound/socket mode (e.g. Slack Socket Mode, Telegram long-polling). To deliver HTTP webhooks, reach the desktop's API through the authenticated proxy `https://www.orgo.ai/api/desktops/{instance_id}/proxy/<path>` (requires your Orgo API key).

## CLI commands

| Command                           | What it does                                 |
| --------------------------------- | -------------------------------------------- |
| `hermes`                          | Start an interactive chat session.           |
| `hermes setup`                    | Re-run the full guided setup.                |
| `hermes model`                    | Switch LLM provider or model.                |
| `hermes tools`                    | Enable or disable tools.                     |
| `hermes gateway setup`            | Wire up Slack, Discord, and other platforms. |
| `hermes config set <key> <value>` | Update a single config value.                |
| `hermes update`                   | Pull the latest Hermes release.              |
| `hermes doctor`                   | Diagnose install or config issues.           |

Full reference: [hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs).

## Sizing

| Workload                           | RAM    | CPU          |
| ---------------------------------- | ------ | ------------ |
| Single user, terminal chat         | 8 GB   | 4 cores      |
| Skills, browser tools, gateway     | 16 GB  | 4 to 8 cores |
| Long-running flows with many tools | 32 GB+ | 8 cores      |

## Tips

* Identity and learned skills live in `~/.hermes/`.
* For multi-tenant setups, run one Hermes computer per user.