voicemaster

Real-time AI phone calls. A caller (or a person being called) talks to a Gemini Live assistant over a Vobiz or Twilio phone line. The library is the whole calling engine: the HTTP routes the telephony provider calls, the live audio stream in both directions, the Gemini Live session, the tools the assistant may use (end the call, transfer it, search the customer's documents), and the signed reports of how each call went.

pip install voicemaster
python -m voicemaster.server        # Vobiz at /vobiz/..., Twilio at /twilio/..., one port (PORT, default 8760)

Settings (environment variables)

The library never loads a .env file; load it yourself (dotenv.load_dotenv()) before importing voicemaster. Calling credentials (Vobiz / Twilio accounts, the Gemini key, the assistant's prompt) arrive per call, never from settings.

Building blocks

from voicemaster.request import VOBIZ, parse_call_request     # check a POST /start body
from voicemaster.tools import build_tools                      # end_call / transfer_call / search_knowledge
from voicemaster.live import live_config                       # the Gemini Live settings for a call
from voicemaster.call_events import sign                       # the HMAC signature of a report

See voicemaster/__init__.py for the full map of modules.