selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
AIReceptionist logo

Self-host AIReceptionist

v0.2.0

Open-source AI phone receptionist with speech-to-speech

BetaOpen SourceAGPL-3.0
Updated2 weeks ago
LanguagePython
Setup difficultyAdvanced
Stars
151
Requires
LiveKit server, OpenAI API (Realtime access), SIP Trunk Provider (Twilio, Telnyx, or Signalwire)
Install with Python

What is AIReceptionist?

A self-hosted AI receptionist that handles phone calls through OpenAI's Realtime API, delivering natural voice conversations without the lag of traditional transcription pipelines. It plugs into telephone networks using LiveKit and SIP providers such as Twilio or Telnyx. Business behavior is defined in YAML files — FAQs, routing rules, schedules, voice choice, and persona. One agent instance serves many businesses. It can forward callers to specific extensions, capture messages sent to files or webhooks, record and transcribe calls, expire old data automatically, schedule appointments via Google Calendar, switch languages mid-call, and play custom closed-office greetings. Requirements are Python 3.11+, an OpenAI key, a LiveKit instance, and a SIP trunk. Licensed AGPL-3.0; still in active development.

Should you self-host AIReceptionist?

AIReceptionist scores 44/100 on selfhost.directory (how scoring works) and ranks #16 of 16 in VoIP. It has 151 GitHub stars.

It shipped 1 stable release in the past year. The latest, v0.2.0, came out on 16 September 2026.

Setup is advanced: plan for several services and some ongoing maintenance. It is AGPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is dograh (70/100, 5 975 stars). It scores higher overall, so compare the two before you pick. See AIReceptionist vs dograh side by side.

Features

  • After-hours detection
  • Call Recording
  • Call transcripts
  • Call transfers
  • FAQ answering
  • Google Calendar booking
  • Inbound phone call handling
  • Message taking
  • Multi-business support
  • Multi-language Support
  • Noise cancellation
  • Retention Policies
  • Speech-to-speech conversations
  • YAML-based configuration

AIReceptionist README

How to install AIReceptionist

Install AIReceptionist with Python

Environment variables
LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET, RECEPTIONIST_AGENT_NAME, OPENAI_API_KEY, plus optional SMTP/Resend/AWS/Slack vars

git clone https://github.com/kirklandsig/AIReceptionist.git cd AIReceptionist pip install -e .

Requires Python 3.11+

How to configure AIReceptionist

  • AWS_ACCESS_KEY_IDAWS access key ID for S3-compatible recording storage

    AWS access key ID for S3-compatible recording storage

  • AWS_DEFAULT_REGIONAWS default region for S3-compatible recording storage

    AWS default region for S3-compatible recording storage

  • AWS_SECRET_ACCESS_KEYAWS secret access key for S3-compatible recording storage

    AWS secret access key for S3-compatible recording storage

  • LIVEKIT_API_KEYLiveKit API key

    LiveKit API key

  • LIVEKIT_API_SECRETLiveKit API secret

    LiveKit API secret

  • LIVEKIT_URLws://localhost:7880WebSocket URL for LiveKit server

    WebSocket URL for LiveKit server

  • OPENAI_API_KEYStandard OpenAI API key (sk-...) for Realtime API authentication

    Standard OpenAI API key (sk-...) for Realtime API authentication

  • RECEPTIONIST_AGENT_NAMEreceptionistProduction dispatch name for LiveKit dispatch rules

    Production dispatch name for LiveKit dispatch rules

  • RESEND_API_KEYResend API key for email sender

    Resend API key for email sender

  • SLACK_TOKENSlack webhook token for webhook channel headers

    Slack webhook token for webhook channel headers

  • SMTP_PASSWORDSMTP password/app password for email sender

    SMTP password/app password for email sender

  • SMTP_USERNAMESMTP username for email sender

    SMTP username for email sender

AIReceptionist releases & version history

More in Business Software

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…