# ${PROJECT_SLUG}

Single-agent FastAPI service generated from the ${SDK_DIST} **`basic`**
scaffold variant (v${SCAFFOLD_VERSION}).

> Development starter: before production, pin the container base image by
> digest and lock every dependency with reviewed hashes.

## Files

- `agent.py` — the `Agent` factory and its `@tool` definitions.
- `main.py` — FastAPI app with `/health` and `/run`.
- `pyproject.toml` — runtime + dev deps; install with
  `pip install -e .[dev]` or `uv sync`.
- `.env.example` — runtime env defaults; copy to `.env` and edit.
- `Dockerfile` — builds a `python:3.12-slim` image that runs `main.py`.

## Run locally

```bash
pip install -e .
python -m uvicorn main:app --host 0.0.0.0 --port 8080
```

Then:

```bash
curl http://127.0.0.1:8080/health
curl -X POST http://127.0.0.1:8080/run \
    -H 'content-type: application/json' \
    -d '{"prompt": "hello"}'
```

## Extending

Add a tool:

```python
from ${SDK_NAME} import tool

@tool("reverse", "Reverse a string")
async def reverse(text: str) -> str:
    return text[::-1]
```

…then append it to the `tools=[...]` list in `build_${PROJECT_SLUG_SNAKE}_agent`.
