| name | service-blueprint |
| description | New service template for Fawkes — file structure, main.py, Dockerfile. Load when creating a service. |
| license | MIT |
| compatibility | opencode |
New Service — Fawkes
Structure:
services/NAME/
app/main.py # FastAPI + OTEL + health endpoints
app/routes/health.py
requirements.txt # pinned deps
Dockerfile # multi-stage, non-root
README.md
main.py:
from fastapi import FastAPI
from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
app = FastAPI(title="NAME", version="0.1.0")
FastAPIInstrumentor.instrument_app(app)
@app.get("/health")
async def health(): return {"status": "ok", "service": "NAME"}
@app.get("/ready")
async def ready(): return {"status": "READY"}
Dockerfile:
FROM python:3.12-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
FROM python:3.12-slim AS runtime
RUN useradd -r appuser
WORKDIR /app
COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
COPY app/ ./app/
USER appuser
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
After creating: add to docs/API_SURFACE.md.
