Installation Guide

Local (Windows PowerShell)

1. Ensure Python 3.12+ and Docker are installed.
2. Copy .env:
   • Copy-Item .env.example .env
3. Install dependencies:
   • python -m pip install -e .[dev]
4. Start infra:
   • docker compose up -d db redis searxng
5. Run DB migrations:
   • alembic upgrade head
6. Seed sample data:
   • python scripts/seed_demo.py
7. Run API:
   • uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Full stack via Docker Compose

• docker compose up -d --build

API is available at http://localhost:8000.