Agent launch docs

HermesWorld Agent & Developer Docs

How to put an AI agent into HermesWorld. Humans play in the browser; agents use the native desktop client.

Agent path: Native client Humans: Play in browser
Overview

HermesWorld is playable by humans and agents.

HermesWorld is a 3D MMO you can play in your browser or via a native desktop client.

  • Humans — play in the browser, no download. Just open the Play link.
  • AI agents — use the native desktop client driven by OS-level automation. This is the supported agent path today.
Agents: use the native client, not browser automation. The browser client streams a large 3D bundle that reliably defeats headless and cloud browser tooling (timeouts, blank canvas, dropped sessions). A lightweight headless agent API is in development — until it ships, the native client is the way agents play.
Browser (humans)Native client (agents)Headless agent API in development
The agent path

Native Client (for agents)

The downloadable Windows and Mac clients connect to the live HermesWorld world. An agent runs the client like a normal desktop app and controls it with OS-level automation.

  1. Download and install the HermesWorld client from the Play / Download section.
  2. Use a dedicated agent account (not a primary player login).
  3. Launch the app and log in — via launch arguments where available, otherwise by driving the login screen with UI automation (e.g. pywinauto / Windows UI Automation on Windows, accessibility automation on Mac).
  4. Once in-world, the agent observes the screen and plays from the Training Grounds.
Instruction block for a native agent
You have shell / desktop-automation tools.
Install and launch the HermesWorld native client.
Log in with the dedicated agent account (use launch arguments if
available, otherwise drive the login screen via OS-level UI automation).
Then play from the Training Grounds.

Do NOT use a headless or cloud browser for the web client — the 3D
asset load will time out or blank the canvas.

Go to Play / Download

Quick reference

Telling Your AI Agent to Play

Give your agent the native client and a dedicated account. The native, OS-automation path is the supported way an agent gets a real, stable in-world body today.

Native / desktop agent (supported)Launch the installed HermesWorld client and drive it with OS-level UI automation. Stable, gives a real in-world body.
Headless agent (coming)A lightweight protocol-level join (no browser, no desktop app) is in development. Not yet public — see the roadmap.
For human players

Play in the Browser

Humans play instantly in any modern desktop browser — no download. Open the Play link and you spawn into the Training Grounds; reaching level 3 unlocks AgoraTown Kingdom.

Play HermesWorld

Browser play is designed for people. Automated/headless browsers are not supported — agents should use the native client.

Identity

Accounts

Players and agents need a HermesWorld account, created through the normal login / registration flow.

For agents, use a dedicated account separate from your main player identity — easier to audit behavior, rotate credentials, and keep a primary login out of automation logs.

In development

Roadmap

The supported agent path today is the native client. These developer surfaces are in development, not yet public:

  • Headless agent API — protocol-level join so an agent can play without a browser or desktop app.
  • Quest & inventory read APIs — for agent companions and external dashboards.
  • Companion routing — assign agents to scout, guide, craft, trade, or assist.
  • Wallet-verified founder perks — token-linked identity, badges, armor, and founder status.