Skip to content
stacks

FastAPI service (Python API)

A Python JSON API on FastAPI and Uvicorn with no frontend, managed with uv and make. pytest runs the real app in process, structlog request logs carry ids, errors share one envelope, and verify fails when the committed OpenAPI spec drifts.

What done means

Your agent follows the brief, then runs stacks verify without weakening or skipping checks. What happens next

Declared steps: install, lint, typecheck, test, openapi-drift, api, readme-filled. View commands

Use this stack

Paste the prompt into the coding agent working on your project.

Project intent

Uses the stack’s default fragments. Review the brief with your agent.Uses stated defaults and omits deploy, release, and app fragments unless explicitly requested.

View prompt
Use the python-api stack for this project. 1. Run npx @steamfield/stacks show python-api --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new python-api and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.
Use the python-api stack for a quick local experiment. 1. Run npx @steamfield/stacks show python-api --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new python-api --sandbox and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.
Or use the terminal
npx @steamfield/stacks new python-api
npx @steamfield/stacks new python-api --sandbox
Verify steps
StepPhaseLayerCommand
installsetupinstallmake install
lintchecklintmake lint
typecheckchecktypecheckmake typecheck
testchecktestmake test
openapi-driftcheckcheckmake check-openapi
apiserveservemake start
readme-filledcheckchecktest -s README.md && ! grep -n 'stacks:fill' README.md

Usage and outcomes

Usage over time

Showing 180 days of history.

History

The 28-day green rate at each weekly observation. Gaps mean the sample was too small to publish.

Jul 1Oct 10%50%100%
Jul 1Oct 10%50%100%
Jun 1Jul 1Aug 1Sep 1Oct 10%50%100%
Jun 1Jul 1Aug 1Sep 1Oct 10%50%100%
Jul 1Oct 10%50%100%
Jul 1Oct 10%50%100%
Jun 1Jul 1Aug 1Sep 1Oct 10%50%100%
Jun 1Jul 1Aug 1Sep 1Oct 10%50%100%

Shaded band: 95% Wilson interval. Dashed rules: content changes. Missing observations remain gaps.

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Data table
ThroughGreen rateProjectsContent change
5 Jul 2026hidden: too few projects––
12 Jul 2026hidden: too few projects––
19 Jul 2026hidden: too few projects5–
26 Jul 2026hidden: too few projects10–
2 Aug 2026hidden: too few projects15–
9 Aug 2026hidden: too few projects15–
16 Aug 2026hidden: too few projects20–
23 Aug 2026hidden: too few projects20–
30 Aug 2026hidden: too few projects20–
6 Sept 2026hidden: too few projects20–
13 Sept 2026hidden: too few projects20–
20 Sept 2026hidden: too few projects20–
27 Sept 2026hidden: too few projects20–
4 Oct 2026hidden: too few projects20–
11 Oct 2026hidden: too few projects20–
18 Oct 2026hidden: too few projects25–
25 Oct 2026hidden: too few projects25–

Weekly projects by preset

Non-overlapping seven-day project counts, grouped by the preset used to start the project.

Jul 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jul 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jun 1Jul 1Aug 1Sep 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jun 1Jul 1Aug 1Sep 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jul 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jul 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jun 1Jul 1Aug 1Sep 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
Jun 1Jul 1Aug 1Sep 1Oct 1012345default · 2 Aug 2026: 5default · 4 Oct 2026: 5default · 18 Oct 2026: 5
  • default
  • sandbox

Stacks projects per UTC week through 30 Oct 2026. Published preset counts only; hidden cells are not zero.

Data table
Week endingPresetProjects
5 Jul 2026default–
12 Jul 2026default–
19 Jul 2026default–
26 Jul 2026default–
2 Aug 2026default5
9 Aug 2026default–
16 Aug 2026default–
23 Aug 2026default–
30 Aug 2026default–
6 Sept 2026default–
13 Sept 2026default–
20 Sept 2026default–
27 Sept 2026default–
4 Oct 2026default5
11 Oct 2026default–
18 Oct 2026default5
25 Oct 2026default–
5 Jul 2026sandbox–
12 Jul 2026sandbox–
19 Jul 2026sandbox–
26 Jul 2026sandbox–
2 Aug 2026sandbox–
9 Aug 2026sandbox–
16 Aug 2026sandbox–
23 Aug 2026sandbox–
30 Aug 2026sandbox–
6 Sept 2026sandbox–
13 Sept 2026sandbox–
20 Sept 2026sandbox–
27 Sept 2026sandbox–
4 Oct 2026sandbox–
11 Oct 2026sandbox–
18 Oct 2026sandbox–
25 Oct 2026sandbox–

By preset

Green verify outcomes by the preset chosen at scaffold time.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

By agent

Within this stack, listed alphabetically. These are project outcomes, not an agent ranking.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Time to green

Published time summaries on a shared minutes scale. First passing test is a median; 75% reached green by the 75th percentile.

Median to green
–
75th percentile
–
First passing test
–
Verify runs to green
–

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Data table
MeasureTime / runs
Median to green–
75th percentile–
First passing test–
Verify runs to green–

Where it breaks

A run can fail more than one step. Environment failures are shown separately.

typecheck43%
test38%
lint10%
openapi-drift5%
install5%
Environment blocked0%

Share of failed runs before first green. Environment blocked describes the machine, not the stack.

Data table
StepShare
openapi-drift5%
lint10%
typecheck43%
test38%
install5%
Environment blocked0%

What people change

Defaults people keep, and optional fragments they choose to attach.

Default, kept rate

agent-ops100%
git-hookshidden: too few projects
ci-githubhidden: too few projects

Optional, attach rate

postgreshidden: too few projects
docker-deployhidden: too few projects
rest-api21%
rrhidden: too few projects
ce-plugin29%

Share of the window's 25 projects. Kept rate is 1 minus the without rate.

Data table
FragmentMeasureShare
agent-opsKept100%
git-hooksKept–
ci-githubKept–
postgresAttached–
docker-deployAttached–
rest-apiAttached21%
rrAttached–
ce-pluginAttached29%
By composition 10 fingerprints

Each row is a distinct fragment composition, with its own sample and content history.

CompositionGreen rateSeenChange in life
defaults + rest-api · 13de0a93hidden: too few projects9 Aug 2026 – 25 Oct 2026None
defaults + ce-plugin − git-hooks · 14993d9ehidden: too few projects11 Oct 2026 – 25 Oct 2026None
defaults + ce-plugin + postgres · 2f603f86hidden: too few projects18 Oct 2026 – 25 Oct 2026None
defaults + ce-plugin + rest-api + rr · 44ef17d9hidden: too few projects23 Aug 2026 – 25 Oct 2026None
defaults + docker-deploy · 5bc69b25hidden: too few projects26 Jul 2026 – 25 Oct 2026None
defaults + postgres · a8575ec8hidden: too few projects5 Jul 2026 – 25 Oct 2026None
defaults + ce-plugin + docker-deploy + rest-api · b193aa82hidden: too few projects30 Aug 2026 – 20 Sept 2026None
defaults + ce-plugin · cf58b5achidden: too few projects23 Aug 2026 – 25 Oct 2026None
defaults · e2e1b88bhidden: too few projects19 Jul 2026 – 25 Oct 2026None
defaults + postgres − ci-github − git-hooks · fe7497a3hidden: too few projects18 Oct 2026 – 25 Oct 2026None

Dependencies in use

Major versions reported by this stack's projects in the 28-day window. Declared dependencies remain listed above.

alembic– reporting projects
Major 1hidden: too few projects
asyncpg– reporting projects
Major 0.32hidden: too few projects
fastapi15 reporting projects
Major 0.162100%
httpx15 reporting projects
Major 0.28100%
mypy15 reporting projects
Major 2100%
pydantic15 reporting projects
Major 2100%
pytest15 reporting projects
Major 9100%
ruff15 reporting projects
Major 0.17100%
sqlalchemy– reporting projects
Major 2hidden: too few projects
uvicorn15 reporting projects
Major 0.54100%

This compares projects; it isn't an effect of the dependency.

Computed 31 Oct 2026, through 30 Oct 2026. Numbers describe stacks projects, not the ecosystem.