// uses

What I use to build and run Synapse

The software behind synapsereality.io and our products, Fax for Agents and Live Tennis API. Each entry is in a manifest or a deploy file of one of those projects, and each line says why it is there. Software only.

34 entriesChecked against the code 8 November 2026

Languages

Python
Every back end: this site's API, Fax for Agents, Live Tennis API and our internal SEO task tracker.
TypeScript
The browser side and this site's build checks, so a renamed field fails the build before it reaches a page.
SQL
Written by hand where a report or a migration needs it, next to the ORM.

Frameworks and libraries

Astro
This site and faxforagents.com. It builds plain HTML, so a page needs no server to render.
Preact
The few interactive parts of this site, such as the instant audit, in a small runtime.
React, Vite and TanStack Query
The Fax for Agents dashboard and our internal consoles, where data changes while the page is open.
FastAPI
The Fax for Agents API and our internal tools. The OpenAPI schema it writes feeds the typed client in the Fax for Agents dashboard.
Flask
This site's small API for forms and the audit queue, and Live Tennis API.
SQLAlchemy and Alembic
Database access and migrations that only move forward.
MCP Python SDK
The hosted MCP server that lets an AI agent send a fax.
Pydantic
Checks request bodies at the edge of the FastAPI services, before any of it is trusted.
Typer
Command lines for operators, so the same action works from a terminal and from the API.
structlog
Logs as structured events, so a filter can strip secrets before a line is written.

Databases

PostgreSQL
The main store for Fax for Agents, Live Tennis API and our internal tools.
SQLite
This site's API. One file holds the form submissions and the audit queue.
Redis
Runs beside Postgres in the Fax for Agents stack.

Hosting and operations

Linux servers, with systemd and Docker Compose
Services run under systemd, most as a dedicated user, or as a Compose stack. No platform sits in between.
Cloudflare
DNS, the CDN, Tunnel and Turnstile. Through Tunnel, this site's server opens no inbound web port.
nginx
Serves the static pages and sets the security headers in front of this site and Fax for Agents.
gunicorn and uvicorn
The application servers: gunicorn for Flask, uvicorn for FastAPI.
GitHub
Code, pull requests and reviews.
Better Stack
Uptime checks and alerts for Fax for Agents.

Services

Google Workspace
Mail for synapsereality.io.
Resend
Transactional mail from this site, sent from plain HTTP calls with no SDK.
Stripe
Billing for Fax for Agents.
PostHog, Google Analytics and Microsoft Clarity
Measurement on this site. In the EU, the EEA, the UK and Switzerland none of them loads until a visitor accepts.

Tests and checks

pytest
The Python test suites, with Hypothesis for property tests.
Vitest
Unit tests for the React dashboards.
Playwright and axe-core
Browser tests, accessibility checks and screenshots at phone and desktop widths.
Lighthouse CI
Performance and accessibility budgets for the marketing sites.
Ruff and mypy
Python lint and type checks.
ESLint and Stylelint
Lint for the dashboards' TypeScript and CSS.
pip-audit
Flags a Python dependency with a known vulnerability.
uv and pnpm
Package managers with lockfiles, used for this site and the Python services.

< Ben's profileWhat we publish as open source