Hermes Atlas
Messaging bridges & gateways

hermes-even-ai-plugin

kisaragi-mochi/hermes-even-ai-plugin

Even Realities G2 smart-glasses HUD adapter that lets you talk to Hermes Agent through the Even App

In short

hermes-even-ai-plugin is a Hermes Agent platform plugin that connects Even Realities G2 smart glasses to Hermes through the Even App's Add Agent feature, showing replies on the glasses HUD.

What hermes-even-ai-plugin does

The Even App's Add Agent feature takes an HTTPS URL and a bearer token, then forwards G2 voice input as OpenAI-compatible chat-completion POST requests and prints the reply on the HUD. This plugin is the endpoint on the Hermes side. It registers an even-ai platform with ctx.register_platform, so it appears in hermes status next to Telegram, and sessions, memory, skills and MCP are preserved.

Replies that finish within about 28 seconds appear on the HUD. Slower replies return a placeholder first, and the real answer is pushed through Telegram, which also carries proactive sends from skills and cron jobs because Even AI is request and response only. The Even App sends two parallel POSTs per turn, so the adapter shares one in-flight future between them. Output has markdown stripped and is cut at sentence boundaries to 400 characters for the 576 by 136 monochrome display. A debug echo mode, EVEN_AI_DEBUG_ECHO_DELAY, returns a fixed reply after a set delay. The adapter listens on port 8767.

Key features

  • Registers even-ai as a first-class Hermes platform
  • Safe against the Even App's two parallel POSTs per turn
  • Two-stage slow-reply flow with a placeholder and Telegram fallback
  • G2-aware formatting: markdown stripped and 400-character truncation
  • Telegram routing for proactive sends and cron deliveries
  • Debug echo mode for measuring Even App behavior

When to use it

  • Asking a Hermes agent a question by voice through smart glasses
  • Getting long answers delivered to Telegram when they miss the HUD deadline
  • Receiving cron job results from Hermes through the Telegram fallback

Who it is for: Owners of Even Realities G2 glasses who run Hermes Agent and want a voice front end.

How it fits with Hermes Agent

A Hermes gateway platform plugin that makes Even AI a platform alongside Telegram and Discord; it was tested on Hermes Agent v0.13.0.

Requirements: Hermes Agent v0.13.0 or compatible, Python 3.11+, Even Realities G2 glasses with the iOS Even App, and an HTTPS reverse proxy in front of port 8767

Note: The project is alpha, and the Even App side of the protocol is undocumented and reverse-engineered, so Even App updates may break it.

FAQ

What is hermes-even-ai-plugin?

hermes-even-ai-plugin is a Hermes Agent plugin that lets Even Realities G2 smart glasses talk to Hermes through the Even App's Add Agent feature. Replies show on the glasses HUD.

Does hermes-even-ai-plugin work with Hermes Agent?

Yes. It registers an even-ai platform in Hermes and was tested on Hermes Agent v0.13.0 with an Even G2 and the Even App. Older versions may lack the platform-registration hooks it uses.

What do I need to run hermes-even-ai-plugin?

You need Hermes Agent v0.13.0 or compatible, Python 3.11+, Even G2 glasses with the iOS Even App, and an HTTPS reverse proxy in front of port 8767, since the Even App refuses plain HTTP.

Similar messaging for Hermes Agent

All messaging

Related guides: How to run Hermes Agent securely · Run multiple Hermes agents with profiles