USSD & SMS (Africa's Talking)

From its catalog listing

Use Hermes from any phone, including feature phones with no internet: dial a USSD code for an instant menu, ask a question, get the agent's answer by SMS, and read long answers back page by page on USSD. Africa's Talking (Kenya, Uganda, Tanzania, Rwanda, Nigeria, Malawi and more). Closed by default (allowlist), phone users get the `safe` toolset, store-first at-most-once SMS outbox, daily SMS cap.

Good to know before installing

opens an HTTP listener on 127.0.0.1:8790 (loopback; the user exposes it through their own tunnel or reverse proxy); makes outbound HTTPS calls only to api.africastalking.com / api.sandbox.africastalking.com (SMS API), sending reply text and the recipient's number; every question and reply crosses the mobile operator and Africa's Talking as plain-text USSD/SMS; stores phone numbers and reply text in a 0600 SQLite file in Hermes plugin storage (7-day default retention, `hermes ussd purge`); runs an outbox worker and an hourly purge task inside the gateway process; Africa's Talking callbacks are unsigned, so the secret URL path is the only authentication (rotate with `hermes ussd rotate-secret`), and anyone holding that URL or spoofing an allowlisted sender number gets an agent turn with this profile's memory and the `safe` toolset (web, vision, image generation) by default; `AT_ALLOW_ALL_USERS=true` lets any phone start turns on the user's account; sending SMS costs money on the user's Africa's Talking account (daily cap of 200 on by default); `hermes ussd setup` writes its own AT_* values to the Hermes .env; no telemetry, no shell commands, no self-update, no binaries.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs AT_USERNAME, AT_API_KEY, AT_WEBHOOK_SECRET), then asks whether to turn it on.
    hermes plugins install hermes-ussd
  2. Said no? Turn it on later:
    hermes plugins enable hermes-ussd
  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
Dixon-O (Community)
Needs
AT_USERNAME AT_API_KEY AT_WEBHOOK_SECRET API keys
Needs Hermes
0.22.5 or newer
Version
0.1.0
In the catalog
2026-11-12

Known issues (from its catalog listing)

  • Needs an Africa's Talking account. The free sandbox works for development; a live USSD code needs approval from Africa's Talking and the mobile operators.
  • Africa's Talking callbacks are unsigned; authenticity rests on the secret URL path.
  • One listener per Africa's Talking account and port (shared-ingress multiplexed profiles are not supported).
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