An elastic, session-oriented remote-browser service: the gateway receives API calls from clients, spins up an isolated Chromium instance on the least-loaded worker, and relays the Chrome DevTools Protocol (CDP) stream over a WebSocket.
PostgreSQL records long-lived session metadata, Redis keeps fast-changing state, and MinIO stores optional video or HAR recordings.

1. Client posts “create session” to the gateway.
2. Gateway selects the least-loaded worker from a Redis ZSET and asks it to start a new Chromium process (one per session).
3. Worker returns its chosen debug port plus the browser GUID; gateway stores that in Redis and Postgres.
4. Client upgrades to WebSocket /session/{id}; gateway pipes every CDP frame between the client and worker.
5. A background “sweeper” in the gateway terminates idle or long-running sessions and updates both Redis and the database.

All services run in Docker; no system packages are required beyond Docker Engine + Compose.

docker compose build
docker compose up -d

Unit tests target both the CDP proxy and the session machinery.
Insert the Test commands snippet below in the repo root.

pytest -q test_cdp.py
pytest -q test_parallel_validate.py
pytest -q test_parallel.py

Adjust these in docker-compose.yml as needed.

docker compose down -v