HackKosice Backend

FastAPI backend for HackKosice.

Setup

venv + pip (recommended for team members)

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

conda

conda env create -f environment.yml
conda activate hackkosice-backend

Running

uvicorn app.main:app --reload

API will be available at http://localhost:8000.
Interactive docs at http://localhost:8000/docs.

Structure

app/
├── main.py           # FastAPI app entry point, CORS, router registration
├── core/
│   └── config.py     # Settings loaded from .env
├── api/
│   └── routes/       # Add route files here, register them in main.py
└── models/           # Pydantic models / schemas

Environment variables

Copy .env.example to .env and adjust as needed.