The Connect technology stack
Connect is a Python application. FastAPI runs under Uvicorn, SQLAlchemy reaches PostgreSQL, and a no-build browser frontend talks to it. It is hosted on an AWS server behind Caddy, and systemd supervises it. LiveKit and Connect AI's realtime speech model carry live calls over a Vobiz phone line. Mail goes through Stalwart, which relays outbound mail through SMTP2GO, WhatsApp through Meta's Cloud API, and payments through Cashfree. This page is the inventory; each row links to a page of its own.
How to read this library#
The rest of the technology reference explains ideas and standards: SIP, DKIM, row-level security, retrieval. This group is different. It covers the products and libraries Connect is built from, found by reading the repository's own dependency files, vendored code and host scripts rather than from a list of what such a product usually uses.
Every page has the same order, so the same answer is always in the same place:
- What it is. For anyone, in plain words, with the category and the official site.
- Where Connect uses it and how it connects. The files and the path a request takes.
- Benefits and limits, security and privacy, and licence, cost and versions.
- Troubleshooting and the official references.
The request path, end to end#
A request from a browser passes through six steps to reach the database. Each one is a page in this library.
- Browser: plain ES modules, no build step (the browser frontend)
- Caddy: TLS, compression and the reverse proxy
- Uvicorn: the ASGI server on the loopback port
- FastAPI and Starlette: routing, middleware and validation through Pydantic
- SQLAlchemy and psycopg: the ORM, the workspace kernel and the driver
- PostgreSQL 16 on the same host, with row-level security
A phone call takes a second path that does not pass through the web server at all:
- The caller dials a number on the Vobiz carrier
- The carrier's SIP trunk delivers the call into a LiveKit room
- The
connect-voiceworker (systemd) joins the room - A realtime speech model session listens and speaks
- At the end the worker posts the call to the application, which writes it to PostgreSQL
Where Connect uses each piece#
| Technology | Category | In Connect (as recorded) | Licence |
|---|---|---|---|
| Python | Language | 3.12 on the host (ops/aws/bootstrap-host.sh) | PSF License |
| FastAPI and Starlette | Web framework | fastapi>=0.115 | MIT; BSD-3-Clause |
| Uvicorn | ASGI server | uvicorn[standard]>=0.30 | BSD-3-Clause |
| SQLAlchemy and psycopg | ORM and database driver | sqlalchemy>=2.0, psycopg[binary]>=3.2 | MIT; LGPL-3.0 |
| PostgreSQL | Database | 16 (host packages) | PostgreSQL License |
| Pydantic | Data validation | pydantic>=2.7 | MIT |
| HTTPX | HTTP client | httpx>=0.27 | BSD-3-Clause |
| cryptography and argon2-cffi | Cryptography | cryptography>=42, argon2-cffi>=25.1,<26 | Apache-2.0 or BSD-3-Clause; MIT |
| Locale libraries | Phone numbers, holidays, time zones | phonenumbers>=9.0.41, holidays>=0.106, tzdata>=2024.1 | Apache-2.0; MIT; Apache-2.0 |
| LiveKit Agents | Realtime media | livekit-agents==1.8.0 | Apache-2.0 |
| Realtime speech model | Model API (Connect AI) | through the LiveKit provider plugin (1.8.0) and HTTPS | Commercial service |
| Vobiz | Telephony carrier | adapter in voice_carriers.py | Commercial service |
| WhatsApp Cloud API | Messaging API | Graph API v21.0 | Commercial service |
| Cashfree Payments | Payment gateway | API version 2025-01-01 | Commercial service |
| Amazon SES | Email sending, where an identity is configured for it | SES v2 through boto3>=1.35 | Commercial service; boto3 Apache-2.0 |
| Stalwart | Mail server; relays outbound mail through SMTP2GO | on the host (ops/mail/) | AGPL-3.0 or the Stalwart Enterprise License |
| AWS hosting | Cloud | EC2, EBS, S3, SSM in ap-south-1 | Commercial service |
| Caddy | Web server | ops/Caddyfile | Apache-2.0 |
| systemd | Service manager | connect, connect-voice | LGPL-2.1-or-later |
| Playwright | Browser automation | playwright==1.63.0 (research, tests) | Apache-2.0 |
| The browser frontend | Frontend | ES modules, no bundler | Connect's own code |
| JsSIP | SIP over WebSocket | 3.13.8, vendored | MIT |
| three.js | 3D graphics | r169 (0.169.0), vendored | MIT |
| GSAP, Lenis and AutoAnimate | Motion | GSAP 3.15.0, Lenis 1.3.26, vendored | GSAP Standard License; MIT; MIT |
| Chrome Manifest V3 | Browser extension | Marketplace Assistant 1.1.0 | Connect's own code |
| Development tools | Quality gates | Ruff, Bandit, the regression runner | MIT; Apache-2.0 |
Some adapters exist in the code for providers a business may choose: Twilio, Plivo and Exotel for calls, MSG91 for SMS, Razorpay and others for payments, Gmail and Microsoft Graph for connected mailboxes. They are covered where the capability is documented. This inventory is the platform's own stack.
What is deliberately absent#
- No JavaScript build step. There is no
package.jsonand no bundler. The browser loads the files it is served, and third-party browser code is vendored with a recorded checksum. - No container orchestrator. One server runs two systemd services, PostgreSQL, Caddy and the mail server. A release is an atomic directory swap with a verified database dump before it.
- No second database. PostgreSQL holds every record. SQLite appears only as a development convenience and is not a production path.
- No secrets on these pages. Credentials live in the host's environment file or a secret store, and each page names the setting, never the value.
Questions#
How was this inventory produced?
From the repository: the three requirements files, the vendored-code record, the host bootstrap and service files, the Caddyfile, and the imports that the backend actually makes. Babel and pycountry, for example, are imported only by an offline data builder, so they appear on the locale page with that caveat rather than as runtime dependencies.
Does Connect use a large language model from one provider only?
No. Connect AI is the product name, and the model underneath each feature is a setting the platform operator chooses, with adapters for several providers. The realtime speech model page covers the live voice. Choosing a model explains how a default is set.
Why are some versions exact and others floors?
The web application's dependencies are floors, so security releases arrive without a code change. The voice worker's packages are pinned exactly, because they were proven together on a real call, and the calling quality is locked: an upgrade there needs a measured call first.