start-local-dev
1
总安装量
1
周安装量
#51787
全站排名
安装命令
npx skills add https://github.com/sjtw/tarkov-build-optimiser --skill start-local-dev
Agent 安装分布
amp
1
opencode
1
kimi-cli
1
codex
1
github-copilot
1
antigravity
1
Skill 文档
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
.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