fairmind (Python SDK)

A small typed client for the FairMind API: read the release gate, run fairness tests, record monitoring snapshots and attestations. One dependency, httpx.

pip install ./apps/sdk        # from a checkout; or: uv add ./apps/sdk
export FAIRMIND_API_URL=https://fairmind.example.com
export FAIRMIND_API_KEY=...   # minted at POST /api/v1/auth/api-keys

from fairmind import FairMind, FairMindError

fm = FairMind()  # reads FAIRMIND_API_URL and FAIRMIND_API_KEY

system = fm.systems()[0]["id"]
run = fm.run_fairness(system, "predictions.csv", outcome="repaid", prediction="approved", attributes=["gender", "region"])
gate = run["gate"]
print(gate["verdict"], gate["confidence"])
for check in gate["checks"]:
    print(check["label"], check["state"])

Methods

The evaluation methods act in the organisation from FAIRMIND_ORG_ID, or the key's first organisation when it is unset.

attributes is a list or a comma-separated string. run_fairness and run_monitoring need prediction (a 0/1 column) or score (a 0 to 1 column). Responses are plain dicts typed with TypedDicts (Gate, GateCheck, ClauseMap, FairnessRun, MonitoringRun, ...).

Every failure raises FairMindError with status_code (None when the server could not be reached) and message (the server's detail when it sent one).

Tests

cd apps/sdk && uv run --with pytest pytest -q -p no:cacheprovider tests