# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working
with code in this repository.

## Overview

wildpc-api is a FastAPI service. Wild PC API.

## Commands

```bash
uv sync                     # Install dependencies
uv run wildpc-api                 # Run service (port 9020)
uv run pytest tests/ -v     # Run tests
uv run ruff check .         # Lint
uv run ruff format .        # Format
```

## Architecture

- `src/wildpc_api/config.py` — Settings via pydantic-settings, env prefix `WILDPC_API_`
- `src/wildpc_api/main.py` — FastAPI app, lifespan, health endpoint
- `tests/` — pytest with TestClient fixtures

## Configuration

Environment variables with `WILDPC_API_` prefix:
- `WILDPC_API_DATA_DIR` — Data directory (default: ./data)
- `WILDPC_API_HOST` — Bind host (default: 0.0.0.0)
- `WILDPC_API_PORT` — Port (default: 9020)