Skip to main content

Running the API Locally

Prerequisites​

  • uv or Docker

With uv​

git clone https://github.com/mu373/epydemix-webapi.git
cd epydemix-webapi
uv sync
uv run uvicorn app.main:app --reload

The API is now running at http://localhost:8000.

With Docker Compose​

docker compose up

For hot reload during development:

docker compose --profile dev up api-dev

Check it's working​

curl http://localhost:8000/api/v1/health
{"status": "healthy", "version": "0.1.1", "epydemix_version": "1.0.0"}

Swagger UI is available at http://localhost:8000/api/v1/docs.