Troubleshooting

Port already in use

• Stop any previous dev servers or change the port with PORT=....

uv sync --all-packages fails or wrong Python version

• Ensure Python 3.13 is installed and selected.
• Re-run uv sync --all-packages from the repo root.

Missing ADC / permission errors

• Run gcloud auth application-default login, or
• Set GOOGLE_APPLICATION_CREDENTIALS to a service account JSON with Spanner, Secret Manager, and Cloud Tasks permissions.

Spanner emulator issues

• Start the emulator and set SPANNER_EMULATOR_HOST=localhost:9010.
• Create the instance/database and apply migrations with ./scripts/liquibase-emulator.sh update.

Protobuf changes not reflected

• Run buf generate from the repo root to refresh packages/python/nest_protos.
• Ensure the Buf CLI is installed and you have access to buf.build.