What problem does it solve?
Telephony integration without changing Hermes core tools by letting you provision an agent number and send/receive SMS and run outbound calls through Twilio, Bland.ai, or Vapi.
Core Features & Use Cases
- Twilio number provisioning & persistence: buy a Twilio number, store it for later sessions, and reuse it as the agent identity.
- SMS/MMS sending and inbox polling: send texts/media from the owned number and later retrieve inbound messages via REST polling (no webhook server required).
- Direct calls and AI-driven outbound calls: place Twilio direct calls using TwiML (<Say>/<Play>) and run AI outbound calls via Bland.ai or Vapi with status checking after completion.
- Safety-first telephony guardrails: built-in rules to confirm before dialing/texting, avoid emergency numbers, and avoid storing third-party numbers in Hermes memory.
Quick Start
Tell the assistant to buy and save a Twilio number by running: python3 telephony/scripts/telephony.py twilio-buy "+17025551234" --save-env