---
title: Reference
review-state: drafting
last-human-review: "2026-06-03"
depends-on: []
owner: tradcliffe
quadrant: reference
---

# Reference

The full API surface, split by audience.

**Public API** is the curated surface a typical user should reach for —
the modules pytyche commits to as stable. Reach for these first.

**Internal** is the full module tree (excluding bench / research infra).
It is intended for power users and extenders who need to find a hook
point or understand internal structure. Symbols here are not part of
the supported public surface; they may change without notice.

```{toctree}
:maxdepth: 2

public
internal
```