person-sdk 1.0.3

Python SDK for the person.run API

person-sdk

Python SDK for the person.run API.

Install

pip install person-sdk

With Pydantic models for typed responses:

pip install person-sdk[models]

Quickstart

from person_sdk import PersonClient

client = PersonClient(
    api_key="your-api-key",
    default_tenant_id="your-tenant-id",
)

persona = client.create_persona(seed={
    "firstName": "Aria",
    "lastName": "Chen",
    "age": 32,
    "location": "San Francisco",
    "baseOccupation": "Product designer",
})

reply = client.prompt(
    persona_id=persona["persona"]["id"],
    user_prompt="How do you approach design challenges?",
)
print(reply["response"])

Features

• Auto-generated Pydantic models from OpenAPI spec (optional)
• Built-in retries with exponential backoff on 429/5xx
• default_tenant_id to avoid passing tenant on every call
• Full coverage: personas, prompting, timeline, populations, and studies
• Zero required dependencies — stdlib only

License

MIT