interpretai 0.1.0

Official Python SDK for the InterpretAI public API.

interpretai

Official Python SDK for the InterpretAI public API.

This package wraps three feature surfaces — Public Reviewer, SSC SRS Review, and RCA — behind a resource-oriented client modelled on the OpenAI and Anthropic Python SDKs. Every long-running surface follows the same submit → get → wait shape.

Install

pip install interpretai

Quickstart

import os
from interpretai import Client
from interpretai.types.public_reviewer import ReviewRequest, Subject

client = Client(api_key=os.environ["INTERPRETAI_API_KEY"])

job = client.public_reviewer.submit(ReviewRequest(
    subjects=[
        Subject(text="Loves trail running and surfing.", label="a"),
        Subject(text="Mostly reads indoors.", label="b"),
    ],
    prompt="Which subject is more outdoorsy?",
    model_tier="tlarge",
))

result = client.public_reviewer.wait(job.job_id, timeout_s=120)
print(result.score, result.reasoning)

Async

import asyncio
from interpretai import AsyncClient
from interpretai.types.public_reviewer import ReviewRequest, Subject

async def main() -> None:
    async with AsyncClient() as client:
        job = await client.public_reviewer.submit(ReviewRequest(
            subjects=[Subject(text="..."), Subject(text="...")],
            prompt="...",
            model_tier="tlarge",
        ))
        result = await client.public_reviewer.wait(job.job_id)
        print(result.score)

asyncio.run(main())

Per-request overrides

fast = client.with_options(timeout=10.0, max_retries=0)
fast.public_reviewer.submit(...)

Configuration

The SDK reads two environment variables when the constructor parameters are not supplied:

• INTERPRETAI_API_KEY — your API key (must start with iai_).
• INTERPRETAI_BASE_URL — base URL (defaults to https://stage-app.interpretai.tech).

Resources

Resource	Methods
client.auth	me()
client.public_reviewer	submit(), get(job_id), wait(job_id, ...)
client.ssc	submit(), get(job_id), wait(job_id, ...)
client.rca	submit(), get(job_id), wait(job_id, ...)

See the top-level SDK README for design notes and roadmap.

License

Apache-2.0