Remote script. The setup command downloads a script from the internet and runs it with sh or PowerShell, so read it before running it on a machine you care about.
Credentials. The command prints a Dashboard password and a QR code that grants access, so do not share the screen or the code with anyone else.
Who it is forA person who runs Hermes Agent on a home computer or server and wants its chat on their Android phone, with no extra account.
The problemHermes runs on a machine you own, but there is no simple way to reach it from a phone without setting up pairing codes, a gateway or API keys.
The outcomeThe phone is connected to the Hermes Dashboard, and you can chat with the agent from Console.
What you need first
- A computer or server where Hermes Agent is installed or can be installed
- Terminal on Linux or macOS, or PowerShell on Windows, on that machine
- An Android phone with Console installed
- Your home network or Tailscale so the phone can reach the Dashboard
Steps
- On the computer where Hermes lives, paste
curl -fsSL https://raw.githubusercontent.com/xP3ta/hermes-setup/main/hermes-dashboard-setup.sh | shinto Terminal (Linux, macOS), or& ([scriptblock]::Create((irm https://raw.githubusercontent.com/xP3ta/hermes-setup/main/hermes-dashboard-setup.ps1)))into PowerShell (Windows). - When the command finishes, note the address, username, password and QR code it shows.
- Open Console and tap I already have Hermes, then scan the QR code.
- Without a camera, tap Connect manually and type the address, username and password.
- Optional check: on the phone, open the Dashboard address on port 9119 in a browser and confirm the sign-in page appears.
Prompt for your agent
For the repo xP3ta/hermes-console, run the Dashboard setup command from the xP3ta/hermes-setup README on <target host> and report the address, username and QR code it prints. Verify that http://<target host>:9119 returns the Dashboard sign-in page before telling the user to connect Console.
Caveat. Console only reaches a Dashboard on a private address such as your home network or Tailscale, so a server on the open internet needs Tailscale or equivalent protection first.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for xP3ta/hermes-console and "Connect your Android phone to your own Hermes agent"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer