Getting Started

Data in. Fair models + Fairness Certificate out. Your data never leaves your machine.

Prerequisites

• Docker Desktop installed and running
• A GitHub access token (provided by Paragon Biosignals)
• Your data as a CSV file

Step 1: Authenticate

echo YOUR_ACCESS_TOKEN | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin

One-time setup. Docker remembers the credentials.

Step 2: Pull the Image

docker pull ghcr.io/paragon-dao/fairness:latest

Step 3: Run the Demo

docker run --rm ghcr.io/paragon-dao/fairness:latest demo

Generates synthetic biased data, trains fair models, outputs certificates. About 10 seconds.

Step 4: Train on Your Data

docker run --rm \
  -v /path/to/your/data:/data \
  -v /path/to/output:/output \
  ghcr.io/paragon-dao/fairness:latest train \
    --input /data/your_data.csv \
    --sensitive-column ancestry \
    --target-column disease_risk \
    --d-sweep \
    --output /output

What --d-sweep Does

Trains 5 models at d=8, 16, 32, 64, 128. Lower d = fairer. Higher d = more accurate. You pick the trade-off.

Step 5: Verify a Certificate

docker run --rm \
  -v /path/to/output:/output \
  ghcr.io/paragon-dao/fairness:latest verify \
    --certificate /output/fairness_certificate_d32.json

Step 6: Upgrade

Data Privacy

• Your data never leaves your machine. The Docker runs locally.
• No telemetry, no phone-home, no data collection.
• Only the Fairness Certificate (metrics JSON) can optionally be submitted to paragondao.org/verify.
• The Docker image contains compiled binaries only — no readable source code.

Support

• General: hi@paragonbiosignals.com
• Pro/Enterprise: phil@paragonbiosignals.com

Patent Notice

Protected by US provisional patents. Evaluation use permitted. Commercial use requires a license from Paragon Biosignals.