python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# or .venv\Scripts\activate  # Windows
pip install -r requirements.txt
uvicorn app.main:app --reload

Configuration

Configuration is managed via YAML files in the config/ directory.

Configuration File

Edit config/settings.yaml to configure your environment:

database:
  active: sql_server  # sql_server or postgresql
  sql_server:
    host: your-host
    port: 1433
    database: your-database
    username: your-username
    password: your-password
  postgresql:
    host: your-postgres-host
    port: 5432
    database: your-database
    username: your-username
    password: your-password

Set database.active to choose the database backend. Both backends expect the same database name, schemas, and table structure.

Local Overrides

For local development, create config/settings.local.yaml to override specific values without committing them.