Python SDK

pip install prysm1

from prysm import Prysm

client = Prysm()  # api_key from $PRYSM_API_KEY, base_url from $PRYSM_BASE_URL

resp = client.chat.completions.create(
    model="auto",                       # let PRYSM pick the best model
    messages=[{"role": "user", "content": "Write a Python quicksort"}],
)
print(resp.choices[0].message.content)

import prysm

ext = prysm.extension(resp)
print(ext.routing.model_display)  # "DeepSeek V4 Flash"
print(ext.routing.reason)         # why this model was chosen
print(ext.cost.total_usd)         # 0.000042
print(ext.proof.proof_hash)       # "sha256:a1b2c3d4..."

client = Prysm()                                   # discovers ./BRAIN.md (walks up from cwd)
resp = client.complete("Summarize this contract")  # BRAIN.md applied

Prysm(brain="path/to/BRAIN.md")
Prysm(brain={"max_cost": 0.005, "model": "deepseek-v4-flash"})
Prysm(brain=None)                # ignore BRAIN.md

r = client.orchestrate(
    "Compare three database designs for a 40-person team",
    policy="depth",            # "efficiency" | "balanced" | "depth"
)
print(r["choices"][0]["message"]["content"])
print(r["prysm"]["orchestration"]["models_used"])  # which models contributed
print(r["prysm"]["orchestration"]["agreement"])    # how strongly they agreed

r = client.orchestrate(
    "Prove that the square root of 2 is irrational",
    policy="depth",
    strategy="debate",         # single | cascade | ensemble_moa | rank_fuse |
                               # decompose_and_route | self_consistency | debate
    k=3,                       # ensemble / sample width
    max_cost_usd=0.05,         # soft budget hint, USD
)

r = client.code(
    "Write a thread-safe LRU cache in Python with tests",
    policy="depth",            # "efficiency" | "balanced" | "depth"
)
for f in r["files"]:
    print(f["path"]); print(f["content"])
print(r["passed"])                              # did the critic pass?
print(r["prysm"]["code"]["coder_models"])       # who wrote it
print(r["prysm"]["proof"]["proof_hash"])        # verifiable proof

r = client.code(
    "Implement rate limiting middleware",
    coder_model="claude-sonnet-4.5",   # who writes the code
    reviewer_model="deepseek-v4-pro",      # who critiques it
    max_iters=4,                       # generate + up to 3 repairs
    max_cost_usd=0.10,                 # soft budget hint, USD
)

quick = client.code("Write a Python hello world", review=False)  # single shot, no critic

p = client.compliance_preview(
    "summarize this report",
    compliance={"jurisdiction": ["EU"], "frameworks": ["GDPR"], "data_residency": ["EU"]},
)
print(p["allowed_models"])           # only EU/GDPR providers survive
print(p["compliance_cost_premium"])  # what compliance costs vs. unrestricted

r = client.orchestrate(
    "Explain photosynthesis.",
    policy="balanced",
    compliance={"provider_allowlist": ["anthropic"]},  # confine to approved providers
)
print(r["prysm"]["compliance"])                  # the exclusion decision
print(r["prysm"]["proof"]["compliance"])         # the attestation

client.route("debug this function")     # dry-run: which model, est. cost (no call)
client.usage()                          # your usage stats
client.savings(baseline="gpt-5.2")      # est. $ saved vs. an all-premium baseline
client.verify_proof(request_id)         # verify a PrysmProof
client.models_catalog()                 # 27 models with pricing

print(client.validate_brain(open("BRAIN.md").read()))
# {'valid': True, 'errors': [], 'warnings': [], 'normalized': {...}}