>_ HERMES CONSOLE
android client · hermes agent
Hermes — the face of your agent

HERMES CONSOLE

Your AI agent, in your pocket.

capabilities

 > capabilities

Not a chat app.
A console.

  1. > chat --streaming --sse --attachments

    Streaming chat

    Real-time conversation with your Hermes Agent: responses arrive token by token, with visible reasoning and attachments. No cloud, no middlemen.

  2. > workspace --sessions --kanban --profiles

    Full workspace

    Sessions, kanban board, model picker and agent profiles. Full command of your Hermes, not just the chat.

  3. > term --ssh --sftp --pty

    SSH terminal + SFTP

    A real terminal inside the app: SSH shell with a PTY and an SFTP browser to move files between your phone and your server.

  4. > cron --cron --jobs --reports

    Cron & automation

    Create, edit and trigger scheduled jobs from your phone. Native cron syntax, remote or local execution, reports for every run.

  5. > approve --risk --notifications

    Approvals with judgement

    The agent asks before acting: every command arrives with its risk level and you approve or reject it — even from a notification with the app closed.

  6. > spark --companion --moods

    Spark, your companion

    Hermes' spark lives in the app: an animated mascot that mirrors your agent's state — thinking, connecting, celebrating.

> the app

The whole console, in your hand.

Streaming chat, a full workspace —sessions, kanban, models, SSH terminal— and your agent always one tap away. This is Hermes Console from the inside.

Agent kanban board in Hermes Console
Streaming chat in Hermes Console
Hermes Console theme gallery

 > connection

One server, or as many as you want.

Hermes Console is a pure client: your agent runs on your machine and the app connects over whatever network you choose. Nothing leaves that loop.

  1. > connect --qr --gateway

    Paired in seconds

    Scan the QR the installer prints and the app configures itself: host, port and key. Prefer manual? Host, port 8642 and your API key.

    remote · qr pairing · streaming

  2. > instances --multi --switch

    All your instances

    Home, VPS, homelab: save each server with its encrypted key and switch between them on the fly. The app diagnoses what every instance supports.

    multi-gateway · diagnostics · keystore

 > demo --play

See it in action.

A real session: connect, converse, schedule. No marketing tricks.

hermes-console · demo.mp4 rec

 > setup --guide

Three steps. Your wire.

From zero to commanding your agent in minutes. No telemetry along the way.

1

Install the server

One command on your server, VPS or homelab. It brings up the Gateway, the Dashboard and the Mobile Bridge as services that survive reboots.

curl -fsSL … | sh
2

Scan the QR

The installer prints a pairing QR. Scan it from the app and the connection configures itself. Prefer manual? Host, port and API key.

hermes://pair
3

Command from your pocket

Done: chat, cron and your agent streaming back, from anywhere.

hermes > ready

Want the full step-by-step? Read the guide →

 > privacy --audit

Privacy first.
By design.

Not a marketing promise. It's the architecture. Hermes Console has nowhere to send your data, because it never touches it.

  • No telemetry Zero analytics, zero tracking, zero calls home. telemetry
  • No third-party accounts No login, no cloud provider between you and your agent. accounts
  • No data in the cloud Everything lives on your device and your server. Nothing else. cloud
  • Encrypted on device Your API key is stored encrypted in the Android Keystore. keystore
  • Minimal permissions Only what it needs to work. Nothing extra. perms

 > docs open

Documentation.

The essentials to connect your agent. No detours.

Complete step-by-step guide Install the server, pair via QR, app tour and troubleshooting. So nobody gets lost. open guide →
Requirements --requirements
  • Android 7.0 or newer
  • A Linux server (VPS, homelab, mini-PC…) with systemd running Hermes Agent
  • The phone must reach the server over the network: LAN, Tailscale or HTTPS
Server install --install
  1. On your server, run the one-line installer: curl -fsSL …/hermes-mobile-setup.sh | sh
  2. It installs Hermes Agent if missing and brings up three services: Gateway (:8642), Dashboard (:9119) and Mobile Bridge (:9131)
  3. When it finishes, it prints a pairing QR for the app

The services are user systemd units: they survive reboots without touching anything.

Connecting --connect
  1. With QR: scan it from the app (or open the hermes://pair link) and you're done
  2. Manually: host (LAN IP, Tailscale IP or domain), port 8642 and your API key (API_SERVER_KEY in ~/.hermes/.env)
  3. You can save several instances and switch between them

How you expose your server is up to you: local network, Tailscale or direct HTTPS. The app just needs to reach it.

Settings --settings
  • Themes — 13 dark and light themes, including pure OLED; font and text size to taste
  • Language — Spanish and English
  • App lock — biometrics or PIN
  • Notifications — approvals and runs in the background, no Google services
  • Gateway URL and API key — encrypted in the Android Keystore
FAQ --faq

Does it work without internet? Yes, as long as phone and server share a network.

TLS certificate error. On a private network use LAN or Tailscale; for public domains, a valid certificate on the gateway.

I lost the QR. Run hermes-pair.sh on the server and it prints it again, no reinstall.

Does it collect data? No. No telemetry, no tracking. See the privacy section.

 > install hermes-console

Your agent awaits.

Download it, connect it to your Hermes Agent and take command from your pocket.

> donate --kofi
open on ko-fi.com ↗