Skip to content

Quickstart

Get Climate-Lama running locally in minutes.

Prerequisites

  • Docker and Docker Compose
  • Python 3.12+
  • uv package manager

1. Clone the repository

git clone https://github.com/CortoMaltese3/climate-lama.git
cd climate-lama

2. Start infrastructure

docker compose up -d

This starts PostgreSQL with PostGIS, MinIO (object storage), and Redis.

3. Apply migrations

uv run alembic upgrade head

4. Run the API

uv run uvicorn climate_lama.main:app --reload

The API is now available at http://localhost:8000. Browse the interactive docs at http://localhost:8000/docs.

5. Run a test job

python scripts/demo.py

If this fails partway through, see the Troubleshooting runbook for per-service (Postgres/Redis/MinIO/API/worker) failure triage.

6. (Optional) Seed onboarding demo data

Populates the database with a worked Greek-flood scenario and creates demo@example.com so you can test the UI onboarding banner and guided tour:

make seed-demo

See Demo data seeder for how to set a usable password and run the full browser smoke check.

Next steps