Skip to content

Releases: HenWorks/Hermes-agent-android-PC-companion-app

v1.1.7

Choose a tag to compare

@github-actions github-actions released this 04 Sep 04:29

What's fixed

The packaged app now honours CLI arguments. --session, --host, --port and --home
were silently ignored whenever the tray icon came up — which is every desktop GUI session.
companion.py only forwarded arguments on the headless fallback path, and the tray entry
point never looked at argv at all. So hermes-companion --session <id> showed the pairing
QR instead of the handoff QR (#1), and --host <vpn-ip> had no effect.

With this release:

  • hermes-companion --session <session_id> → the browser console shows the handoff QR
    (scanning it pairs the phone and hands over that conversation).
  • hermes-companion --host 100.x.x.x → binds and advertises that address, for pairing over
    a VPN / Tailscale instead of the LAN IP.

One-click Hermes companion apps (no Python needed).

  • macOS — open hermes-companion-macos.dmg, drag Hermes Companion
    to Applications, then open it from Applications. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
    To reinstall: quit the running one first (menu-bar icon → Quit).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect. Runs in the menu bar / tray.

v1.1.6

Choose a tag to compare

@github-actions github-actions released this 04 Sep 03:04

What's fixed

The pairing QR now shows up everywhere — including Windows.
The QR used to be drawn by Python's qrcode/pillow, but the only thing that installed
them was mesh-start.sh — a bash script using POSIX venv paths. On Windows (install from
source) it could not run, so import qrcode failed and the console silently fell back to
"QR failed". Without a QR the only way to pair was to hand-copy a 140+ character JSON blob
from the PC to the phone. The QR is now generated in the browser: no Python dependency,
works offline and on every platform.
(The prebuilt binaries already bundled qrcode, so they were not affected — this fixes the
"Install from source" path.)

The SQLite handle is now released on shutdown (Windows file lock).
Thanks to @Sajid-ul-Islam for finding and reporting this in #5. An open WAL connection kept
queue.db locked on Windows, blocking temp-dir cleanup. stop() now waits for the in-flight
task to write its result before closing the database — if a task is still running it
deliberately leaves the handle open, because losing a user's answer is worse than a file lock.


One-click Hermes companion apps (no Python needed).

  • macOS — open hermes-companion-macos.dmg, drag Hermes Companion
    to Applications, then open it from Applications. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
    To reinstall: quit the running one first (menu-bar icon → Quit).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect. Runs in the menu bar / tray.

v1.1.5

Choose a tag to compare

@github-actions github-actions released this 02 Jul 13:57

One-click Hermes companion apps (no Python needed).

  • macOS — open hermes-companion-macos.dmg, drag Hermes Companion
    to Applications, then open it from Applications. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
    To reinstall: quit the running one first (menu-bar icon → Quit).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect. Runs in the menu bar / tray.

v1.1.4

Choose a tag to compare

@github-actions github-actions released this 02 Jul 12:17

One-click Hermes companion apps (no Python needed).

  • macOS — open hermes-companion-macos.dmg, drag Hermes Companion
    to Applications, then open it from Applications. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
    To reinstall: quit the running one first (menu-bar icon → Quit).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect. Runs in the menu bar / tray.

v1.1.3

Choose a tag to compare

@github-actions github-actions released this 02 Jul 11:53

One-click Hermes companion apps (no Python needed).

  • macOS — unzip, then double-click Hermes Companion.app. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect.

v1.1.2

Choose a tag to compare

@github-actions github-actions released this 02 Jul 11:46

One-click Hermes companion apps (no Python needed).

  • macOS — unzip, then double-click Hermes Companion.app. First launch:
    right-click → Open (unsigned app; one-time Gatekeeper approval).
  • Windows — unzip, double-click hermes-companion.exe. If SmartScreen
    appears: More infoRun anyway.
  • Linux — unzip, then run hermes-companion.AppImage
    (chmod +x if your browser cleared the executable bit).

The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect.

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 29 Jun 17:05

Standalone Hermes companion binaries (no Python needed).
Download the archive for your OS, unzip, and run hermes-companion.
macOS/Windows are unsigned — first run may need: macOS right-click → Open;
Windows "More info" → "Run anyway".

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 29 Jun 16:22

Standalone Hermes companion binaries (no Python needed).
Download the archive for your OS, unzip, and run hermes-companion.
macOS/Windows are unsigned — first run may need: macOS right-click → Open;
Windows "More info" → "Run anyway".

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 29 Jun 16:06

Standalone Hermes companion binaries (no Python needed).
Download the archive for your OS, unzip, and run hermes-companion.
macOS/Windows are unsigned — first run may need: macOS right-click → Open;
Windows "More info" → "Run anyway".