Python (experimental)

Python is an experimental, explicit opt-in Putnami workspace surface for small services, libraries, data workloads, and automation. It is not a default project path and has no compatibility or feature-parity promise with Go or TypeScript.

Status: extension-first. Python is limited to templates, dependency sync, lint, test, serve, and Docker packaging. Putnami does not ship a Python framework package family.

What is ready today

Capability Where to start Why it matters
First experiment Getting Started Explicitly create a service or library experiment through Putnami
Project lifecycle Extension phases Detection, dependency sync, test, lint, serve, Docker, uv, Ruff, pytest
New services and libraries Templates python-server and python-library start with workspace conventions
Workspace orchestration Tooling & Workspace Explicitly configured Python projects participate in graph selection and impacted jobs
Automation output CLI Deterministic command output for CI and agents
Fast feedback loops Jobs & caching Cache-aware test/lint/serve behavior inside the shared runner

Good fits

Use experimental Python inside Putnami when you deliberately want:

  • a FastAPI service created from the python-server template
  • an importable package created from the python-library template
  • data, ML, or automation code in the same repo as product services
  • CI and agent workflows that call putnami test, putnami lint, and putnami serve instead of bespoke scripts
  • a small Docker-ready experiment without hand-maintaining the initial project shape

How Python fits the workspace

Explicitly configured Python projects are workspace nodes. They can be selected, tested, linted, and served through Putnami commands, while Python-specific behavior stays delegated to uv, Ruff, pytest, and the generated project shape. This does not imply that Python is default, production-ready, or equivalent to the Go and TypeScript surfaces.

putnami deps add @putnami/python
putnami extensions install
putnami projects create recommender --template python-server
putnami deps install
putnami test recommender
putnami serve recommender
  1. Read Getting Started to create an experimental Python service or library.
  2. Use How To / Guides for concrete workspace tasks.
  3. Read Extension phases for the exact jobs and options.
  4. Read Templates before creating a new Python project.
  5. Read Workspace if you need to understand how Python projects participate in impacted work.

If you need a richer web or backend framework today, start with TypeScript or Go, then use Python where it adds the most leverage.