Back to selected work

Usage observability for Hermes

quota-hermes

Expose quotas, windows, balances, context and qualified cost without sending provider credentials to the browser.

StatusOpen source · version 1.0.4 published
Public source
Local backend workflow Providers → Local backend → Desktop. Fictional data Providers01 Local backend02 Desktop03 Fictional data

01

The problem

AI provider limits and costs are heterogeneous. Missing data must never become a fake zero, and provider keys must not flow into the desktop widget.

02

My role

Generalising an existing fork, adding providers and focused-session context, hardening distribution, testing installation and publishing the open-source release.

03

Key decisions

  1. Query providers from the local backend only; the widget reads a credential-free cache.
  2. Qualify cost as real, API-equivalent, subscription-included or unavailable.
  3. Degrade each provider independently on failure.
  4. Publish a clean history with upstream attribution and autonomous CI.

04

Demonstrable outcome

Version 1.0.4 is public, installable in single-host or split gateway/desktop modes and verified by CI. Updates stay deliberate: no silent auto-update mechanism is included.

05

Technologies

  • Python
  • JavaScript
  • Hermes Plugin SDK
  • GitHub Actions
  • JSONL

AI assistants accelerated parts of the design and development work. Network/security decisions, acceptance criteria, testing and validation remain human-led and human-verified.