Skip to content

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.