Dial-a-Hermes (USSD)

From its catalog listing

Talk to Hermes from any phone with no data: a USSD gateway platform (Africa's Talking-compatible callback) with 182-char paged replies, a 'thinking, press 1 to check' flow for long turns, keypad exec approvals (1 Approve / 2 Deny, full command shown first, Hermes's own approval flow), clarify answers, optional SMS of the full reply, English/Nigerian Pidgin menus and a local feature-phone simulator. Owner-only phone allowlist, fails closed.

Good to know before installing

opens a local HTTP listener (default 127.0.0.1:8095) for POST /ussd/<secret-token> and GET /health, plus a loopback-only simulator page when USSD_SIMULATOR=true; Africa's Talking does not sign callbacks, so the secret token in the URL is the boundary; outbound calls only when USSD_SMS_MODE=africastalking, to api.africastalking.com / api.sandbox.africastalking.com (reply text and the owner's number); stores per-phone language choice in the plugin data folder; no telemetry.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs USSD_ALLOWED_USERS, USSD_CALLBACK_TOKEN), then asks whether to turn it on.
    hermes plugins install dial-a-hermes
  2. Said no? Turn it on later:
    hermes plugins enable dial-a-hermes
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Languages & regions · Web, research & browsing · Chat apps & voice
Maintained by
ebohdarlington123-cmyk (Community)
Needs
USSD_ALLOWED_USERS USSD_CALLBACK_TOKEN API keys
Needs Hermes
0.23.1 or newer
Version
0.1.0
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • Needs a public HTTPS URL (tunnel or reverse proxy) and an Africa's Talking account (free sandbox) for real phones; the bundled simulator works locally without either.
  • USSD gives each callback about 10 seconds and a session about 3 minutes; longer agent turns continue in the background and are read with "1 Check again" or by dialing back.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in languages & regions

All languages & regions plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins