runtm init backend-service
cd backend-service
runtm run

backend-service/
├── runtm.yaml              # Deployment manifest
├── runtm.discovery.yaml    # Search metadata
├── Dockerfile              # Container build
├── pyproject.toml          # Python dependencies
├── app/
│   ├── main.py             # FastAPI entry point
│   ├── api/
│   │   └── v1/
│   │       ├── health.py   # Health endpoint
│   │       └── routes.py   # Your API routes
│   ├── services/           # Business logic
│   │   └── processor.py    # Example service
│   ├── core/
│   │   ├── config.py       # Settings
│   │   └── logging.py      # Structured logging
│   └── db/                 # Database (if enabled)
│       ├── __init__.py
│       ├── base.py
│       ├── session.py
│       ├── migrations.py
│       └── models/
├── tests/
│   └── test_health.py
├── README.md
├── AGENT.md
└── CLAUDE.md

from fastapi import FastAPI
from app.api.v1 import health, routes
from app.core.logging import setup_logging

setup_logging()

app = FastAPI(
    title="My API",
    version="1.0.0",
    docs_url="/docs",
    openapi_url="/openapi.json",
)

app.include_router(health.router)
app.include_router(routes.router, prefix="/api/v1")

# app/api/v1/items.py
from fastapi import APIRouter

router = APIRouter(prefix="/items", tags=["items"])

@router.get("/")
async def list_items():
    return {"items": []}

@router.post("/")
async def create_item(name: str):
    return {"id": 1, "name": name}

from app.api.v1 import items
app.include_router(items.router, prefix="/api/v1")

# app/services/processor.py
class Processor:
    def process(self, data: dict) -> dict:
        # Your logic here
        return {"result": data}

from app.services.processor import Processor

processor = Processor()

@router.post("/process")
async def process_data(data: dict):
    return processor.process(data)

# runtm.yaml
features:
  database: true

# app/db/models/item.py
from sqlalchemy import Column, Integer, String
from app.db import Base

class Item(Base):
    __tablename__ = "items"
    
    id = Column(Integer, primary_key=True)
    name = Column(String, nullable=False)

from fastapi import Depends
from sqlalchemy.orm import Session
from app.db import get_db
from app.db.models.item import Item

@router.get("/items")
def list_items(db: Session = Depends(get_db)):
    return db.query(Item).all()

env_schema:
  - name: DATABASE_URL
    type: url
    required: false
    secret: true
    description: "External PostgreSQL (optional, uses SQLite by default)"
  
  - name: API_KEY
    type: string
    required: true
    secret: true
    description: "External API key"

runtm secrets set API_KEY=xxx

# Run with hot reload
runtm run

# Or manually
uvicorn app.main:app --port 8080 --reload

# Run tests
pytest

# With coverage
pytest --cov=app

# Validate first
runtm validate

# Deploy
runtm deploy

# View logs
runtm logs dep_xxx --type runtime