SKILL.md
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-modeServices
| 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:startImport Pipeline Development
task compose:up
task importer:start:use-cacheEvaluator Development
task compose:up
task importer:start:use-cache
task evaluator:start:test-modeTroubleshooting
Database connection fails:
- Check if database is running:
docker compose ps - Verify
.envhas correctPOSTGRES_*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