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
- 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 - Said no? Turn it on later:
hermes plugins enable hermes-ussd - 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_USERNAMEAT_API_KEYAT_WEBHOOK_SECRETAPI 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

Full setup & settings ↗Source code ↗
More in languages & regions
All languages & regions plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher