Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
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 Windows?
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 powershell -ExecutionPolicy Bypass -File .\setup.ps1. 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: winget install Git.Git
git clone https://github.com/jbrazy480/ai-receptionist.git cd ai-receptionist
Python 3.x (no version pinned)
winget install Python.Python.3.12
Fill in secrets: OPENAI_API_KEY, TWILIO_AUTH_TOKEN
Copy-Item .env.example .env
python -m venv .venv .venv\Scripts\Activate.ps1 pip install -r requirements.txt pip install -r requirements-dev.txt
No reports for Windows yet.
GitManual AI Agent reads the 8 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.