hermes atlas
318·repos hermes·v0.23.1 ★ star this repo
handbook · mobile

Hermes Mobile: your agent, away from your desk

How the official phone app works, what the beta shows, and how to get useful work done without handing an agent unlimited authority.

Research checked November 12, 2026 · Native-app examples from Tonbi’s November 3 beta tour · Published November 13, 2026

Start here: the official Hermes Mobile page currently offers an iOS and Android beta waitlist, not a guaranteed immediate download. If you need phone access now, Nous also documents opening a Cloud agent in your phone’s browser. That is a separate route, not admission to the native beta.

← All Hermes guides · Choose your setup · Desktop guide

1. What Hermes Mobile actually is

Hermes Mobile is Nous Research’s official iPhone and Android companion app for Hermes Agent. Think of it as a control surface for your agent: a place to open conversations, inspect work, review files, and manage capabilities while the agent’s backend does the execution.

The important distinction is phone interface versus agent runtime. Tonbi’s beta tour connects to a remote machine; Nous’s Cloud offering runs a hosted agent in its own container. Neither is evidence that the full agent or its model runs locally on your phone. Your files, tools, credentials, and persistence depend on the backend and profile you select. [Video: backends] [Nous: Cloud]

A useful mental model: the phone is where you direct and review work; the backend is where the work happens. A disconnected phone is not the same as a stopped backend, although beta reconnection and background behavior should not be assumed flawless.

2. Get the right app, not a lookalike

Nous launched the mobile beta at NousCon in late October. On November 3, it said the beta had filled quickly and directed people to the waitlist while it worked toward wider availability. The current official page still uses that waitlist. No general-release date was established in the sources reviewed. [Nous announcement]

  1. Open the official mobile page and select your platform.
  2. Follow the current enrollment or invitation instructions. The beta has used TestFlight for iOS and Firebase App Distribution for Android; old invitation links are not a reliable access path.
  3. Check the publisher and invitation provenance before installing or entering credentials. Nous has specifically warned about apps that imitate Hermes branding. [Official warning]

Also distinguish the official app from the community hermes-mobile adapter. That plugin gives developers a WebSocket interface for their own clients. Its installation commands, token variables, and port are not a verified setup recipe for Nous’s native app. Separately labeled community clients can be legitimate without being official.

3. Choose where your agent lives

Option A: Nous Cloud

This is the lower-maintenance route. Nous’s November 9 announcement says to choose an agent name and model in Nous Portal, then open the agent in the Webapp from your phone. It says Plus, Super, and Ultra each include one Cloud agent, hosted around the clock. Check current plan terms before subscribing; hosting entitlement does not establish unlimited model or third-party tool usage. [Source]

Useful while waiting: this phone-browser route does not require a native-beta invitation. It is not the same interface-distribution mechanism as installing the mobile app.

Option B: your own computer or server

Tonbi’s beta shows gateway-address and SSH/Mosh connection options, and a terminal connected to his remote machine. That establishes what his build exposed, not a universal onboarding flow. Complete current native-app setup documentation was not found, so follow the instructions supplied with your invitation rather than guessing ports or installing unrelated adapters.

Prepare a running backend, configured model access, supported authentication, and a secure route from your phone to the host. A sleeping laptop cannot serve as an always-available agent. Prefer a trusted VPN or tunnel and proper authentication over exposing a powerful service directly to the internet.

A documented self-hosted browser alternative

The official Desktop documentation separately describes serving its workspace through the gateway:

hermes config set webapp.enabled true
hermes gateway restart
hermes webapp

These are Webapp commands, not native-mobile pairing commands. The documented default is host-local 127.0.0.1:9120; typing that address on a phone points at the phone itself. Remote access needs the documented networking and authentication setup. Use HTTPS for remote browser features such as microphone access. [Official Webapp guide]

4. Make your first session deliberately boring

Before connecting sensitive accounts or scheduling work, verify the basics with a harmless request:

“Tell me which profile and working directory this session uses. Do not read secrets, change files, or contact external services.”

Then ask it to create a small sample note in a clearly specified scratch folder and confirm you can inspect the resulting artifact. Check the selected model, workspace, and tool activity. Start a second session only after the first behaves as expected. Separate profiles and group chats are not a substitute for OS-level isolation or account permissions.

5. What the beta puts on your phone

Tonbi’s 7-minute tour is a useful map of the app. The following are attributed beta observations, not a promise of identical screens or feature parity in every build:

Voice: dictation is not the same as Live Mode

The tour identifies voice dictation and a Live Mode control. Crucially, the creator says Live Mode is not configured in his demonstration. Do not infer tested pause-to-send timing, lock-screen listening, offline transcription, or always-on conversation from that menu. Voice may depend on microphone permission and backend speech-provider configuration. [Video] [General Hermes voice docs]

6. Understand skills, connections, plugins, and MCP

Composio offers one optional route to external apps through its MCP-compatible Connect service, with browser-based account authorization. Its public Connect documentation and Hermes troubleshooting guide are useful integration references. There is no verified basis here to claim the official mobile app’s Connections screen is specifically powered by Composio, or that installing it is required.

Connect only what a workflow needs. Reading a calendar, sending an email, changing a billing record, and posting publicly are different permissions and should have different approval boundaries. [Skills] [MCP]

7. Three workflows worth starting with

Prepare for a meeting

“Using only the documents I attach, give me the decisions needed, unresolved questions, and three things to ask. Do not message anyone or modify the originals.”

Review work already in progress

“Show me the latest draft artifact from this session. Summarize what changed and what was actually verified. Do not publish, deploy, or merge anything.”

Set a recurring research brief

“Propose a weekday 8 AM America/Puerto_Rico brief on these three topics. Show the schedule, sources, and delivery destination before creating it.”

After reviewing the proposal, explicitly authorize creation, inspect the saved routine, and test delivery. Hermes routines are backend jobs, not phone alarm-clock reminders. The gateway must stay running, the destination must be configured, and each run can consume model or tool usage. [Scheduling docs]

8. Safety, limits, and quick troubleshooting

Treat backend access like access to a powerful computer account. The official Webapp security guidance warns that a signed-in user can run commands, use files, and reach the host account’s environment and credentials. Protect your phone, avoid sharing credentials or public screenshots containing secrets, and require approval before destructive changes or external writes.

Bottom line: Hermes Mobile is most useful as a way to direct, inspect, and approve backend work while away from a desk. Start with one profile and one read-only workflow, then add accounts, automation, and delegation only when you understand where execution and data actually live.

Sources and verification notes

This guide combines the video’s recovered public transcript, first-party Nous announcements, current official documentation, and Composio’s public docs. No native app was installed or independently exercised. Beta UI observations are attributed rather than presented as current setup guarantees.

  1. Tonbi’s AI Garage: Hermes Mobile App Sneak Peek, November 3, 2026; public transcript and chapter links.
  2. Official Hermes Mobile beta waitlist, checked November 12, 2026.
  3. Nous Research: beta capacity and waitlist, November 3.
  4. Nous Research: Cloud agents in a phone browser, November 9.
  5. Nous Research: impersonator-app warning, October 25.
  6. Official Desktop and Webapp documentation, plus the skills, MCP, voice, and scheduling references linked above.
  7. Composio Connect documentation and Hermes MCP troubleshooting.

Hermes Atlas · Availability, interfaces, and plan terms can change. This guide is not an endorsement of every plugin or similarly named app.