name: start-local-dev description: Start the local development environment with all services (database, API, importer, evaluator)

Start Local Dev Skill

Use this skill when starting or managing local development services.

Quick Start

# Start database (in DevContainer, usually already running)
task compose:up

# Start the API
task api:start

# Optional: import data (if database is empty)
task importer:start:use-cache

# Optional: compute builds (if optimum_builds is empty)
task evaluator:start:test-mode

Services

Importer Variants

Evaluator Variants

Service Dependencies

PostgreSQL
    ├── API (reads builds)
    ├── Importer (writes data)
    └── Evaluator (reads data, writes builds)

Typical startup order:

1. Database: task compose:up
2. Migrations: task migrate:up (if not already applied)
3. Importer: task importer:start:use-cache (if database is empty)
4. Evaluator: task evaluator:start:test-mode (to compute builds)
5. API: task api:start

Common Workflows

API Development

task compose:up
task api:start

Import Pipeline Development

task compose:up
task importer:start:use-cache

Evaluator Development

task compose:up
task importer:start:use-cache
task evaluator:start:test-mode

Troubleshooting

Database connection fails:

• Check if database is running: docker compose ps
• Verify .env has correct POSTGRES_* values

Port already in use:

• Find process: lsof -i :8080
• Kill it: kill -9 <PID>

Stale data:

task compose:down
docker compose down -v  # removes volumes
task compose:up
task migrate:up
task importer:start