Install — Self-Hosted

Run the Worthless proxy in Docker. The container is fully self-contained — it generates its own encryption key and stores all shard data internally.

Quick start (Docker Compose)

git clone https://github.com/shacharm2/worthless && cd worthless/deploy
cp docker-compose.env.example docker-compose.env
docker compose up -d

The proxy starts on localhost:8787. Enroll your API keys:

printf '%s' "${OPENAI_API_KEY:?set OPENAI_API_KEY first}" | docker compose exec -T proxy \
  worthless enroll --alias openai --key-stdin --provider openai

Repeat for each key. The container splits and stores the key internally — the original key never touches disk.

Cloud deploy

From source (no Docker)

git clone https://github.com/shacharm2/worthless && cd worthless
uv pip install -e .
worthless lock
worthless up

The proxy runs on localhost:8787. See the README for the full command reference.