Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Open source AI receptionist starter for local businesses, agencies and GoHighLevel builders. Answers inbound calls with Twilio and OpenAI Realtime, handles FAQs and business hours from YAML, takes messages, transfers calls and books appointments via webhook. Self-hosted Python and FastAPI. Want it done for you? RizzDial.
GitHub didn't answer, so this is the saved copy from 17 h ago
Will it work on macOS?
Heads-upBuilding it yourself? It also needs 7 settings in .env (2 secret).
CONTRIBUTING.mdContributions are welcome. This is a starter project meant to stay small and readable.
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
cp business.example.yaml business.yaml
pytest
python -m receptionist.simulate) working with zero API keys and no network access.receptionist/, tests in tests/.pytest before opening a pull request.Open a GitHub issue with steps to reproduce, what you expected, and what happened instead.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/jbrazy480/ai-receptionist.git cd ai-receptionist
Python 3.x (no version pinned)
brew install python
Fill in secrets: OPENAI_API_KEY, TWILIO_AUTH_TOKEN
cp .env.example .env
python -m venv .venv source .venv/bin/activate pip install -r requirements.txt pip install -r requirements-dev.txt
No reports for macOS yet.
GitManual AI Agent reads the 8 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.