diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 000000000..cefb831a4 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,88 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Running the Application + +**Prerequisites:** Python 3.13+, `uv`, and an Anthropic API key in a `.env` file: +``` +ANTHROPIC_API_KEY=your-key-here +``` + +**Start the server:** +```bash +./run.sh +# or manually: +cd backend && uv run uvicorn app:app --reload --port 8000 +``` + +**Install / sync dependencies:** +```bash +uv sync +``` + +> **Always use `uv` for all dependency management and running Python — never use `pip`, `pip install`, or bare `python` directly.** +> - Add packages: `uv add ` +> - Remove packages: `uv remove ` +> - Sync environment: `uv sync` +> - Run a script: `uv run