Metadata-Version: 2.1
Name: awesome-caller-boi
Version: 0.1.0
Summary: A FastAPI router + Twilio⇆OpenAI realtime streaming helper
Home-page: https://github.com/torndorff5/awesome_caller_boi
Author: Orndorff Automation
Author-email: torndorff5@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi >=0.70
Requires-Dist: uvicorn >=0.15
Requires-Dist: websockets >=10.0
Requires-Dist: twilio >=7.0

# awesome_caller_boi

A small Python package that exposes a FastAPI router to connect Twilio’s voice streaming directly to the OpenAI realtime API (GPT-4o). It handles incoming calls, establishes the WebSocket media stream with Twilio, forwards audio to OpenAI, and sends back OpenAI’s audio response to the caller.

## Features

- Provides a FastAPI router for Twilio voice webhooks.
- Streams inbound audio from Twilio to OpenAI in real time.
- Encodes and forwards OpenAI’s audio responses back to Twilio.
- Automatically handles speech interruptions (caller starts speaking mid-response).
- Easy to configure with your own `get_system_message()` and `get_system_greeting()` callbacks.
- Put your OpenAi key in your enviornment variables and call it OPENAI_API_KEY

## Installation

From PyPI (once published):
```bash
pip install awesome_caller_boi
