Most AI receptionist tools are closed, expensive, and difficult to adapt to real business workflows. LobbyStack is different.

• Open source by default. Inspect the code, self-host it, extend it, and keep control of your data.
• Built for real phone calls. Handle natural voice conversations, interruptions, live transfers, and messages for your team.
• Calls and texts in one place. Review calls, recordings, transcripts, and incoming texts from the same dashboard.
• Scheduling built in. Book, reschedule, and cancel appointments through Google Calendar.
• Designed for small businesses. Guided setup, transparent pricing, and no enterprise-only feature gatekeeping.
• Human fallback. Transfer calls or escalate messages when the AI should not handle something alone.

LobbyStack answers inbound calls with a natural voice agent trained on your business information. It can answer common questions, collect caller details, take messages, qualify requests, offer appointment slots, and transfer to a human when required.

LobbyStack saves texts sent to your business number and alerts your team. You read the thread and reply by hand from the dashboard. The AI doesn't answer texts; STOP and HELP get fixed replies.

LobbyStack connects to Google Calendar, checks availability, offers time slots, books appointments, and sends a confirmation text and one reminder text 24 hours before, if the caller agrees. Callers can also reschedule or cancel during a later call.

Upload business information, FAQs, services, pricing, policies, and internal notes. The AI uses this knowledge to answer accurately and consistently.

LobbyStack can transfer a live call, take a message, or notify the team by email or opt-in SMS when a person needs to respond.

Review calls, SMS threads, transcripts, recordings, appointments, and customer details from one dashboard.

LobbyStack connects to Google Calendar to check availability and book appointments. It doesn't connect to other calendars or CRMs yet.

LobbyStack can be adapted for many local business workflows:

• Clinics and healthcare offices
• Salons, spas, and barbershops
• Auto repair shops
• Home service companies
• Restaurants
• Dental offices
• Law firms and professional services
• Property managers
• Any business that receives appointment, pricing, hours, or availability questions by phone

LobbyStack is open source with a hosted cloud service.

Use LobbyStack Cloud when you want the product managed for you. You still control the receptionist behavior, knowledge, services, rules, numbers, integrations, and team workflow from the app.

Self-host when your team wants to run the stack on your own infrastructure, bring your own API keys, and use your own PostgreSQL, Twilio, OpenAI-compatible AI, calendar, analytics, billing, and email provider accounts.

To self-host on Railway, deploy the LobbyStack template. Railway generates every secret and database password, and you enter an OpenAI API key and your Twilio credentials.

Full product control in the hosted app. Infrastructure ownership when you self-host. Same open-source core either way.

LobbyStack is a TypeScript monorepo with PostgreSQL as the durable source of truth. OpenAI hosts call audio; the admin app starts each call and the worker runs it.

apps/
  admin/           Next.js dashboard and HTTP API
  worker/          asynchronous jobs, outbox dispatch, and live calls
packages/embed/    Vite bundle for the embeddable website widget loader
packages/          database, domain, agent core, jobs, providers, telemetry, and shared contracts
mintlify/          public documentation source
docs/              architecture notes, ADRs, provider docs, and validation notes

Read the self-hosting overview for the provider map and deployment expectations, or use the Docker Compose guide for the official single-host baseline.

1. Create a LobbyStack account.
2. Verify your mobile number.
3. Import website knowledge, or skip and add knowledge manually later.
4. Choose a plan.
5. Claim a business number on Starter or Pro.
6. Configure AI settings, services, knowledge, and rules before sending live calls.

The full hosted walkthrough lives in the setup guide.

cp .env.example .env
pnpm install
docker compose up -d postgres redis
pnpm db:migrate
pnpm dev

Local development stores recordings and uploads under .lobbystack/storage. Set STORAGE_PROVIDER=s3 when you need to test an S3-compatible service.

Mock providers are part of the default development path, so contributors can exercise flows without live Twilio, AI, calendar, or email credentials. Provider setup notes live in the docs.

git clone https://github.com/lobbystack/lobbystack.git
cd lobbystack
pnpm install
cp .env.example .env
# Replace every placeholder before exposing the stack.
docker compose --env-file .env up -d --build

The stack uses stdout logs and health endpoints without running monitoring containers. Set OTEL_EXPORTER_OTLP_ENDPOINT and OTEL_EXPORTER_OTLP_HEADERS to send server telemetry to PostHog or another OTLP-compatible backend.

For prerequisites, local smoke vs production go-live, helper scripts, and troubleshooting, see the Docker Compose self-hosting guide.

Contributions are welcome. Start with CONTRIBUTING.md, keep durable business logic in the domain and database layers, and put the receptionist's tools in the agent core.

Before opening a PR, run:

pnpm typecheck
pnpm build
pnpm test

LobbyStack is licensed under the MIT License.