Configure build and start for FastAPI · Ample Computer

Configure build and start for FastAPI

Configure build and start for a FastAPI app on Ample. Start uvicorn from a small run.py that reads PORT; pass --start "python3 run.py" (or answer the start question ample plan asks). Ample detects the runtime, installs dependencies, runs the build when present and starts the app on the python-3.12 template behind a public HTTPS URL.

What it runs on

You need

Exact tested configuration

installpython3 -m pip install --target .ample/python -r requirements.txt

runtimepython

sizes-1vcpu-1gb

startPYTHONPATH=.ample/python:${PYTHONPATH:-} python3 run.py

templatepython-3.12

Steps

  1. Make the start command bind correctly. Start uvicorn from a small run.py that reads PORT; pass --start "python3 run.py" (or answer the start question ample plan asks).

  2. Deploy. Run the existing synchronous deploy once from the project directory and read the result. Exit 0 is live, 1 is failed, 2 needs an answer first (a preflight question). Re-running with no change is a content-addressed no-op.

   $ ample deploy . --name <app-name> --public --format json --start "python3 run.py"
  1. Verify. Fetch the live URL and run the success checks below. On failure read the build log, then the runtime log, fix the cause and deploy again; do not blind-retry.
   $ ample logs <deployment_id> --kind build

How it was checked

✓ page or root route responds· http get/ → “ample canary fastapi basic”

Evidence

  1. November 5, 2026 · canary run

    FastAPI app installed with pip into .ample/python and started with uvicorn on python-3.12; / and /health served correctly.

Tested examples

What it doesn’t cover