The recommended way to build Python services at our organization.
| Category | Features |
|---|---|
| Core | FastAPI 0.115+, Python 3.12, Pydantic 2.0, async/await |
| Observability | OpenTelemetry + Grafana, Prometheus metrics, structured logging |
| Database | Aurora PostgreSQL/MySQL, DynamoDB, SQLAlchemy 2.0 |
| Cache | ElastiCache Redis |
| Messaging | SQS, SNS+SQS |
| Tasks | Celery, ARQ |
| AI | LangChain, OpenAI, Anthropic, Bedrock |
| Quality | Ruff, mypy, Bandit, pytest |
| DevEx | uv, Makefile, pre-commit, VS Code config |
- Go to Backstage Software Catalog
- Select "Python Service (Golden Path)"
- Fill in the form
- Click "Create"
- Clone and start building
your-service/
├── src/
│ ├── api/ # API routes
│ ├── core/ # Config, logging, middleware
│ ├── db/ # Database layer
│ ├── models/ # Database models
│ ├── schemas/ # Pydantic schemas
│ ├── services/ # Business logic
│ └── main.py # Entry point
├── tests/ # Test suite
├── k8s/ # Kubernetes manifests
├── .github/ # CI/CD workflows
├── docs/ # Documentation
├── Dockerfile # Multi-stage build
├── Makefile # Developer commands
└── pyproject.toml # Dependencies
| Document | Description |
|---|---|
| Decision Guide | How to choose template options |
| Golden Path Overview | What and why |
| Getting Started | First steps |
| Patterns Guide | Service patterns |
- Slack: #platform-help
- Office Hours: Thursdays 2-3pm
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2025-12 | Initial release |
🤘 Platform Team