OnepilotDownload
Onepilot mascot

How to use Hermes Agent from your iPhone

Nous Research's Hermes Agent has no official iPhone app. The two working ways in 2026 are an SSH terminal app running `hermes --tui` against your host, or Onepilot, a native iPhone app that wraps the SSH path with a deploy wizard.

sofiane8910

by sofiane8910 · May 9, 2026 · 6 min read · updated June 21, 2026

Onepilot runs these agents from your iPhone, download it on the App Store.

Short answer: Nous Research has not shipped an iPhone app for Hermes Agent. There are exactly two working ways to run and control it from your phone in 2026:

  1. An iPhone SSH terminal app. SSH into the Linux or macOS host where Hermes is installed, then run hermes --tui (the new TUI, recommended) or hermes (classic CLI). Pure terminal, no UI on iPhone. Works with any iOS SSH client that gives you a real interactive terminal.
  2. Onepilot. A native iPhone app that wraps the same SSH path, but exposes the deploy step, skill triage, channel hookup, and live logs as iOS panels you tap through instead of CLI subcommands you type.

Both options need Hermes already installed on a host you control, your own Mac mini, Linux box, Raspberry Pi, NAS, or a $5/month VPS. Hermes officially supports Linux, macOS, WSL2, and Termux on Android; iOS is not on the platform list, which is why the agent itself runs on the host and your iPhone is the control surface.

In The Pragmatic Engineer's March 2026 AI tooling survey of 906 software engineers, 95% used AI tools at least weekly and 55% regularly ran AI agents (The Pragmatic Engineer, 2026), so the open question is no longer whether to run an agent but how to supervise one away from your desk, which is exactly what running Hermes from an iPhone solves.

The rest of this post explains exactly what to type for each path, plus the lighter chat-channel alternative for cases when you don't want a real session.

How to run Hermes from an iPhone SSH terminal

This is the literal "I'm on my phone, I want to run a command" path. You install Hermes once on the host, then any time you want to drive it from your iPhone you open an SSH session and type hermes --tui.

Step 1, Install Hermes on the host

On your Linux, macOS, WSL2, or Android-Termux host:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup

hermes setup walks you through the model and API-key configuration. Hermes requires a model with at least 64,000 tokens of context, anything smaller is rejected at startup because the agent can't keep enough working memory for multi-step tool calls.

Step 2, SSH from iPhone and run the TUI

From your iPhone SSH client, connect to the host and run:

hermes --tui

The TUI is the recommended frontend. It renders cleanly in any terminal that handles ANSI escapes and a sane character cell size. Classic hermes (no --tui) also works if you prefer the CLI shape.

What you get: the full Hermes interface, skills tree, memory inspection, cron list, live activity, rendered in your terminal. Everything hermes can do on a desktop, you can do over SSH from your phone.

What you don't get: native iOS gestures, push notifications, deploy automation, or pre-wired channel setup. You're typing into a terminal.

This path is the most flexible: if you already use SSH from your phone for other servers, you already know how this feels.

What does Onepilot add over a plain SSH session?

Onepilot is a native iPhone app built around the same SSH connection: it logs into the host and runs your shell exactly as a desktop SSH client would. It targets the same Linux and macOS hosts. The difference is what's on top of the SSH layer.

What Onepilot adds:

What Onepilot doesn't add:

If you only ever run hermes --tui once a day, Path 1 is fine. If you also want to deploy, swap frameworks, manage skills, and handle channel setup from the same app, Path 2 saves the typing. The full Hermes on iPhone page walks through the deploy flow.

Can I control Hermes from a chat app instead?

If you don't want a UI at all and don't want to open a terminal, just want Hermes to do things and tell you about them, Hermes ships with a built-in messaging gateway. Run on the host:

hermes gateway setup

Pick your platform (Telegram, Slack, Discord, WhatsApp, Signal). On your iPhone you open the standard chat app for that platform; Hermes shows up as a participant. You message it, it does the work, it replies.

Strengths: zero app install on iPhone, zero new accounts. Works with whatever chat platform you already use.

Limits: chat-shaped UX. Fine for "summarise the new GitHub issues" or "remind me about X tonight". Not great for inspecting why a skill mis-fired three days ago, you can't scroll a memory tree in a chat bubble.

This is a complement to Paths 1 and 2, not a replacement. Most people run a chat channel plus either SSH or Onepilot.

How to run Hermes without owning a server

Same answer as desktop: you rent one. Hermes runs in 2 GB of RAM cleanly; a $5/month VPS handles it.

ProviderPlanRAMPrice/mo
HetznerCX112 GB~€4
DigitalOceanBasic Droplet1 GB$6
VultrCloud Compute1 GB$6

Once provisioned, SSH in from your iPhone (Path 1) or use the Onepilot deploy wizard (Path 2) and run the install command above. The whole flow, from provision to install to first skill, takes about 15 minutes.

OpenClaw without self-hosting? OpenClaw has the same shape: it runs on a host you own or rent. There is no hosted-OpenClaw service that gives you a phone client without provisioning a server somewhere. The two iPhone paths above (SSH terminal or Onepilot) apply identically. We cover the iPhone OpenClaw path on the OpenClaw page, with an evergreen install in the OpenClaw setup guide.

SSH vs Onepilot vs chat channel: which should I pick?

SSH terminalOnepilotChat channel
Native iPhone appGeneric SSH clientYesUses chat app
Setup work on iPhoneAdd SSH hostSign inNone
Deploy Hermes for youNoYes (wizard)No
Skill triage UITUI in terminalNative panelsNo
Live logsYes (in terminal)Yes (panel)No
Channel setup baked inNo (manual)YesN/A, is the channel
Multi-framework on same hostYes (manual)Yes (wizard)Per-framework
Best forComfortable in a terminalDeploy + supervise from phone"Just message me when done"

If you live in a terminal and have Hermes installed already, Path 1 is the answer.

If you want to deploy, supervise, and triage from one app and skip the install scripting, Path 2 is the answer.

If you only want Hermes to message you results, the chat channel is the answer.

You can run all three at once. The host doesn't care. For the broader Hermes-vs-OpenClaw decision, see Hermes Agent vs OpenClaw.

FAQ

Is there an official Nous Research iPhone app for Hermes?

No, not as of 2026. The official platform list is Linux, macOS, WSL2, and Termux on Android. Nous Research has not publicly announced an iOS roadmap. The two working ways to use Hermes Agent from an iPhone are an SSH terminal session running 'hermes --tui' against the host, or Onepilot, a native iPhone app that wraps the same SSH path with a deploy wizard.

Does Hermes Agent run on the iPhone itself?

No. Hermes runs on a Linux or macOS host. Your iPhone connects over SSH and acts as the control surface. The agent's memory, skills, and cron jobs all live on the host, which means iPhone reboots, low-power states, and roaming networks don't interrupt the agent's long-running work.

Does the chat-channel path keep memory between sessions?

Yes. Hermes's memory layer is independent of the channel, it's stored on the host. A chat-gateway session and a direct 'hermes --tui' session both see the same memory, the same skills, and the same persistent user model. You can switch between paths without losing context.

What's the cheapest 24/7 Hermes Agent setup for iPhone use?

A Hetzner CX11 (~€4/mo) running Hermes Agent plus a chat gateway. Total external cost: ~€4/mo plus your LLM API spend. Hermes runs in 2 GB of RAM cleanly. SSH from your iPhone for control, or use Onepilot's deploy wizard to provision and configure the host without typing commands.

Does any of this work offline?

Hermes itself can run with a local LLM (via Ollama) on a host with enough RAM, so the agent side can be fully offline. The iPhone side still needs network to reach the host. There is no fully-offline iPhone Hermes setup today, because the iPhone is the control surface and Hermes runs elsewhere.

Will Nous Research ship an official iOS app for Hermes Agent?

No public statement either way as of May 2026. Until they do, the working answers are SSH terminal access (running 'hermes --tui'), Onepilot (native iPhone app wrapping the SSH path), or the built-in messaging gateway via 'hermes gateway setup' if a chat interface is enough.

Related reading

Run your AI agents from your iPhone

Download Onepilot on the App Store.

See also: the three-layer agent overview, run Hermes on iPhone, or all articles.