interpretai 0.1.2

Official Python SDK for the InterpretAI public API.

interpretai

Official Python SDK for the InterpretAI public API.

This package wraps three feature surfaces — Match Reviewer, Spec Submittal Compliance Review, Root Cause analysis (RCA), Models behind a resource-oriented client. submit -> get -> wait shape.

API keys

For an API key please email [e-mail] for early access.

Install

pip install interpretai

Quickstart

Hiring

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(pdf="path/to/resume.pdf", label="candidate"),
        Subject(text=[
                "Company A: Working on Agentic AI for job matching", 
                "Looking for talented engineer with experience in the space",
            ], 
            pdf="path/to/relevant/job/description", 
        label="b"),
    ],
    prompt="Is the candidate a good fit, why or why not?",
    model_tier="tlarge",
))

result = client.public_reviewer.wait(job.job_id, timeout_s=1200)
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