From source

Requirements: Python 3.14+, uv, PostgreSQL.

git clone https://github.com/koldakov/proxium.git
cd proxium
uv sync
cp .env.template .env           # fill it in, see Configuration
uv run --env-file .env proxium-manage migrate
uv run --env-file .env proxium-manage createsuperuser

See Configuration for the variables.

Run the proxy:

uv run --env-file .env proxium

uv run --env-file .env python -m proxium

The API is a FastAPI app served by Hypercorn. Extra arguments go to Hypercorn:

uv run --env-file .env proxium-api --bind 127.0.0.1:8000