---
title: pytyche
review-state: drafting
last-human-review: "2026-06-03"
depends-on:
  - README.md
owner: tradcliffe
---

# pytyche

Smarter, calibrated multi-round A/B tests for online experimentation.
Pytyche tells you *which customer segments* drive a treatment's lift
and which don't respond, discovers those segments from your data,
and over a series of rounds proposes redirecting more traffic toward
responders while keeping controls everywhere so measurement stays
honest.

::::{grid} 2
:gutter: 3

:::{grid-item-card} 🚀 Getting Started
:link: getting-started/index
:link-type: doc

Install pytyche from source, run your first fit in five minutes. The
shortest runnable path from install to a posterior you can interpret.
:::

:::{grid-item-card} 🎓 Tutorials
:link: tutorials/index
:link-type: doc

End-to-end walk-throughs. **Your first hurdle BCF fit** takes you
through install, a synthetic adaptive-enrichment dataset, the
canonical fit, and per-segment posterior interpretation.
:::

:::{grid-item-card} 🔧 How-to guides
:link: how-to/index
:link-type: doc

Goal-oriented recipes for specific tasks: apply a shipped calibration
correction, run a power sweep, configure a custom DGP for SBC.
:::

:::{grid-item-card} 💡 Concepts
:link: concepts/index
:link-type: doc

Why the library is built the way it is. Start with
[overview](concepts/overview.md): what pytyche does, who it's for,
and the design lineage. Then drill into the
calibration / hurdle BCF / sequential targeting concept docs.
:::

:::{grid-item-card} 📖 API Reference
:link: reference/index
:link-type: doc

The full API. **Public API** for typical users (the curated surface
the library commits to); **Internal** for extenders and contributors
who need the full module tree.
:::

:::{grid-item-card} 📊 Doc Health
:link: meta/index
:link-type: doc

Live status of the documentation corpus — polish-state breakdown,
drift list, and the per-doc `last-human-review` audit.
:::

::::

## Project status

0.2.1 — published on [PyPI](https://pypi.org/project/pytyche/). The public
API is the curated Reference surface and is stabilizing; internal modules may
change without notice. MIT licensed; source on
[GitLab](https://gitlab.com/tradcliffe2/tyche).

```{toctree}
:hidden:
:maxdepth: 2

getting-started/index
tutorials/index
how-to/index
concepts/index
reference/index
meta/index
```