git404hub

what is hermes-uplink fr?

mr-september/hermes-uplink — explained in plain English

Analysis updated 2026-05-18

10PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A lightweight web client that lets you control a desktop-based Hermes AI agent remotely from a phone or laptop browser via a secure tunnel.

vibe map

mindmap
  root((Hermes Uplink))
    What it does
      Remote web client for Hermes Agent
      Secure tunnel via Tailscale Funnel
      Resumes existing sessions
    Tech stack
      Python proxy
      Vanilla JS client
      Tailscale Funnel
    Use cases
      Control desktop AI from phone
      Avoid screen sharing
      Installable home screen app
    Audience
      Desktop Hermes Agent users
      Remote workflow tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Resume and monitor Hermes Agent sessions from a phone while the actual AI runs on a home desktop.

VIBE 2

Avoid bandwidth-heavy screen sharing by using a lightweight text-based client instead.

VIBE 3

Add the client to a phone's home screen for an app-like way to check on long-running AI sessions.

VIBE 4

Keep the Hermes API key confined to the desktop while still allowing secure remote access.

what's the stack?

PythonJavaScriptTailscale

how it stacks up fr

mr-september/hermes-uplinkaarav90-cpu/fetchitadammartinez271828/x4-analysis
Stars101010
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a Windows desktop with Python 3, the Hermes CLI, and Tailscale for Windows already installed.

MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Walk me through setting up hermes-uplink on my Windows desktop with Tailscale Funnel.
prompt 2
Explain how the proxy in this repo keeps my Hermes API key off my phone browser.
prompt 3
Show me how to add hermes-uplink to my phone's home screen as an installable app.
prompt 4
Help me troubleshoot Tailscale Funnel setup for exposing my local Hermes proxy.

Frequently asked questions

what is hermes-uplink fr?

A lightweight web client that lets you control a desktop-based Hermes AI agent remotely from a phone or laptop browser via a secure tunnel.

What language is hermes-uplink written in?

Mainly Python. The stack also includes Python, JavaScript, Tailscale.

What license does hermes-uplink use?

MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.

How hard is hermes-uplink to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hermes-uplink for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.