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
Service Command Purpose
PostgreSQL task compose:up
Database (required by all services)
API task api:start
HTTP endpoints at localhost:8080
Importer task importer:start
Populate database from tarkov.dev
Evaluator task evaluator:start
Compute optimal builds
Importer Variants
Command Use Case
task importer:start
Fetch fresh data from API
task importer:start:use-cache
Use local cache (faster)
task importer:start:cache-only
Update cache only, skip DB
Evaluator Variants
Command Use Case
task evaluator:start
Full evaluation (slow)
task evaluator:start:test-mode
Limited subset (fast, for development)
Service Dependencies
PostgreSQL ├── API (reads builds) ├── Importer (writes data) └── Evaluator (reads data, writes builds)
Typical startup order:
-
Database: task compose:up
-
Migrations: task migrate:up (if not already applied)
-
Importer: task importer:start:use-cache (if database is empty)
-
Evaluator: task evaluator:start:test-mode (to compute builds)
-
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