Skip to main content

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 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 laptopOrgo cloud computer
UptimeOff when the laptop sleepsContinuous
Reachable from other devicesSame network onlyAnywhere
Persistent state and learned skillsTied to one machineLives in ~/.hermes/ on the computer
Setup per deviceReinstall each timeOne install, one config
IsolationFull access to your personal files, accounts, and credentialsIsolated 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

1

Create the computer

Open 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.
2

Open a terminal on the computer

Open the computer in the dashboard and launch Terminal from the taskbar.
3

Run the installer

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:
source ~/.bashrc
4

Run the setup wizard

hermes setup
For Nous Portal accounts:
hermes setup --portal
5

Start chatting

hermes
Quit with Ctrl+D. Hermes persists everything it learns to ~/.hermes/.

​
Install via the Orgo SDK

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.

​
Keep the computer online

Auto-stop is disabled by default. If you have it enabled and want Hermes to stay online continuously: 
curl -X PATCH https://www.orgo.ai/api/computers/$COMPUTER_ID/auto-stop \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auto_stop_minutes": 0}'
See Auto-stop for the full reference.

​
Messaging gateways

Hermes can accept messages from Slack, Discord, Telegram, email, and more: 
hermes gateway setup
Each Orgo computer has a stable hostname ({instance_id}.orgo.dev), so inbound webhooks can point directly at it.

​
CLI commands

CommandWhat it does
hermesStart an interactive chat session.
hermes setupRe-run the full guided setup.
hermes modelSwitch LLM provider or model.
hermes toolsEnable or disable tools.
hermes gateway setupWire up Slack, Discord, and other platforms.
hermes config set <key> <value>Update a single config value.
hermes updatePull the latest Hermes release.
hermes doctorDiagnose install or config issues.
Full reference: hermes-agent.nousresearch.com/docs.

​
Sizing

WorkloadRAMCPU
Single user, terminal chat8 GB4 cores
Skills, browser tools, gateway16 GB4 to 8 cores
Long-running flows with many tools32 GB+8 cores

​
Tips

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