Python Extension

The @putnami/python extension provides the Python project lifecycle inside a Putnami workspace: dependency sync, test, lint, serve, Docker packaging, and template support.

Python is currently extension-first. The extension gives Python projects the same workspace workflow as TypeScript and Go while keeping Python tools native.

Extension phases

Phase	Start here	What it explains
Setup	Detection & dependencies	How Python projects are found and how uv is used
Feedback loop	Test & lint	pytest, Ruff, and common options
Local runtime	Serve & watch	Entrypoints, ports, and server execution
Release shape	Docker & templates	Docker output and project templates

Enable the extension

putnami deps add @putnami/python
putnami deps install

The extension is auto-discovered from workspace dependencies.

External tools

• Python
• uv
• Ruff
• pytest

Daily loop

putnami test api
putnami serve api
putnami lint,test,build --impacted