mr-september/hermes-uplink

Hermes Uplink is a lightweight web client that lets you control Hermes Agent, an AI assistant that normally runs on a desktop computer, from your phone or laptop browser instead. The idea is to keep your powerful desktop as the place where all the actual work happens, files live, and tools are installed, while you drive it remotely through a simple webpage rather than sharing your whole screen or moving your project files onto a smaller device. It works by running a small proxy program on the desktop that talks to Hermes's own API, and exposing that connection to the outside world through Tailscale Funnel, a secure tunneling service. The API key needed to talk to Hermes never leaves the desktop or reaches the browser, since the proxy adds it to requests on the server side. A separate passphrase is what protects remote access instead, and the README stresses that this passphrase should be treated like a full access password. Once set up, the web interface shows your existing Hermes sessions and lets you resume them, streams the assistant's replies as they are generated, and can be added to your phone's home screen so it behaves like a regular app rather than a browser tab. It automatically refreshes when you return to the tab, so it stays reasonably battery friendly on mobile. Setup requires a Windows desktop with Python 3 and the Hermes command line tool already installed, plus Tailscale for Windows signed in on that machine. No Python packages need to be installed separately, since the proxy only uses Python's built in standard library. A single batch file launches everything: it starts the local proxy if needed, walks you through Tailscale login and permissions, and prints the URL and passphrase you use from your other devices. The project is released under the MIT license.