Choosing packages
This guide helps application authors select pykit packages. Each package's own guide explains its setup and API.
| Need | Start with | Add when needed |
|---|---|---|
| Runtime utilities, configuration, logging or process output | rn-forge-commons |
Its named extras for integrations |
| A batch command or declared command-line application | rn-forge-cli |
rn-forge-tooling for generation, managed files or tool installation |
| A developer tool that installs itself or manages generated files | rn-forge-tooling |
Its tooling-owned [lifecycle] surface |
| HTTP contracts shared across frameworks | rn-forge-web |
A framework adapter for application wiring |
| Authenticating callers and authorizing them by scope or role | rn-forge-auth |
Its oidc extra to verify OIDC bearer tokens |
| A Django service | rn-forge-django |
Django extras such as drf, oidc, fixtures or celery |
| A FastAPI service | rn-forge-fastapi |
oidc or transfer extras |
| Async SQLAlchemy models and persistence helpers | rn-forge-sqlalchemy |
The web contract it already depends on |
| Excel and tabular data helpers | rn-forge-data |
The pandas extra for the pandas adapter |
| CI and release automation for a repository in any language | rn-forge-devops |
Nothing: run it with uvx; it is a CI tool, not an application dependency |
Use rn-forge-web for shared wire behavior, and rn-forge-auth for the
verified caller and the access decision over it. Django and FastAPI bind that
behavior to their frameworks, and their oidc extras install
rn-forge-auth[oidc]. SQLAlchemy is a sibling persistence package; it does not
define a common object-relational mapping layer for the adapters. Application
code imports rn_forge.web directly alongside its adapter, because the adapters
do not re-export it (ADR-0002). Declare rn-forge-web
next to the adapter rather than relying on it arriving transitively. See the
workspace graph for direct dependencies and
import boundaries.
Consumers require pykit packages from PyPI by version range; consuming packages shows how (ADR-0004). The release pages record which tags exist.