Skip to main content
The deutero package is the official Python client for the Deutero Study Management API. It covers the full study lifecycle, so anything you can do in the dashboard you can script, schedule or wire into your own product.

​
What you can build

Design studies

Create studies, draft them from a brief or a landing page, and write or generate the interview questions.

Branching interviews

Author flows with conditional paths, captured variables, live data fetches and outbound signals.

Recruit and embed

Share participation links, attribute arrivals to your own user IDs, or embed the interview in your app.

Rehearse with AI personas

Run simulated interviews against generated personas before a single real participant sees the study.

Analyze responses

Export transcripts, search answers semantically, tally scale and choice questions, and cluster free text into themes.

React to events

Verify signed webhooks when interviews start or complete, studies fill up or credits run out.

​
Highlights

  • Sync and async. Deutero and AsyncDeutero expose the same resources with identical signatures.
  • Typed responses. Every call returns a Pydantic v2 model from deutero.models, and the package ships py.typed for mypy and pyright.
  • Specific exceptions. HTTP errors map to classes such as NotFoundError, ConflictError and InsufficientCreditsError.
  • Webhook verification built in. deutero.webhooks checks Standard Webhooks signatures without needing an API key.
  • Small footprint. The only dependencies are httpx and pydantic. Requires Python 3.9+.

​
Next steps

Quickstart

Install the SDK and run your first study end to end.

SDK reference

Every resource, method, argument and return type.