OSS Maintainer Kit Python Example

This repository shows what the python-package preset from oss-maintainer-kit looks like after scaffolding.

It was generated with:

npx oss-maintainer-kit init . \
  --repo-name oss-maintainer-kit-python-example \
  --maintainer "Blake Hampson" \
  --preset python-package

Why this repo exists

It is a concrete example for Python package authors who want to inspect the packaging- and environment-focused preset before using it on a real project.

Quick scan

• AGENTS.md: packaging, environment, and release expectations
• docs/START_HERE.md: the fastest orientation pass for the repo owner
• docs/MAINTAINER_WORKFLOW.md: how to triage, review, and release changes
• .github/workflows/codex-pr-review.yml: optional AI review automation

What this preset is trying to optimize

• fewer packaging surprises
• clearer review focus around environments and release discipline
• repo instructions that still make sense if the maintainer is working solo

Related project

• Main tool: https://github.com/BlakeHampson/oss-maintainer-kit
• npm package: https://www.npmjs.com/package/oss-maintainer-kit