Python SDK

The Python SDK gives you one root client for PrysmAI's control plane.

pip install prysmai

Think about it this way:

  • PrysmClient is the root client
  • .llm() gives you the proxy path
  • .mcp() gives you the MCP surface
  • .session() gives you a unified run/session scope
  • .openai() remains available as a compatibility alias
from prysmai import PrysmClient

prysm = PrysmClient(prysm_key="sk-prysm-...")
client = prysm.llm()
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}],
)

Metadata

Attach metadata so Prysm can group and investigate traffic meaningfully.

from prysmai import prysm_context

# Set globally — all requests will include these
prysm_context.set(
    user_id="user_123",
    session_id="sess_abc",
    metadata={"env": "production", "version": "1.2.0"}
)

with prysm_context(user_id="user_456", metadata={"feature": "chat"}):
    response = client.chat.completions.create(...)