steipete/vox

Node.js API

15 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

OPENAI_API_KEY secret OpenAI
OPENAI_REALTIME_MODEL secret
OPENAI_REALTIME_VOICE secret
OPENAI_REALTIME_URL secret
OPENAI_INPUT_AUDIO_FORMAT secret
OPENAI_OUTPUT_AUDIO_FORMAT secret
OPENAI_TRANSCRIPTION_MODEL secret
TWILIO_ACCOUNT_SID secret Twilio (required for `vox dial`, optional for inbound hangup tool)
TWILIO_AUTH_TOKEN secret
VOX_PUBLIC_BASE_URL Vox
VOX_AGENT_URL
VOX_AGENT_CMD
VOX_AGENT_TIMEOUT_MS
VOX_LOG_DIR
VOX_INITIAL_GREETING

Alternative Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/steipete/vox

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/steipete/vox

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/steipete/vox

Or deploy to a different host