Python Getting Started

Use Python when the first project is a FastAPI service, importable package, data workload, or automation component that should stay inside the same Putnami workspace graph as TypeScript and Go.

Python is currently extension-first: Putnami gives Python projects templates, dependency sync, lint, test, serve, Docker packaging, and workspace orchestration.

Pick the project shape

You need... Template What you get
A FastAPI service python-server ASGI app, uvicorn serve command, tests, Docker packaging
A shared Python package python-library Importable module, packaging metadata, tests

If you are starting from an empty directory:

putnami init

Create the project

For a service:

putnami projects create api --template python-server
putnami deps install
putnami test api
putnami serve api

For a library:

putnami projects create features --template python-library
putnami deps install
putnami test features

What to look at first

Start with the project lifecycle:

  1. Extension for the exact Python jobs and defaults.
  2. Templates for the generated service and library shapes.
  3. Workspace to understand how Python projects participate in impacted work.
  4. Jobs & caching to keep feedback loops fast.

Daily loop

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

The Python toolchain stays Python-native, but the workflow stays workspace-native.