model-observatory

Installation
SKILL.md

AI Model Observatory

Critical

  • NEVER hardcode model selection -- always query ai_model_recommendations
  • Two sync mechanisms: (1) CLI tool daily-sync.ts for manual/ad-hoc runs, (2) BullMQ kie-observatory.worker.ts for automated weekly sync (Sunday 08:00 UTC). If both stop, pricing goes stale
  • Decision audit is mandatory -- every selection logged to ai_model_decisions
  • Kie.ai credit rate: 1 credit = $0.005 USD
  • New auto-discovered models need manual review before pipeline use

Key Files

File Purpose
tools/model-observatory/seed-initial-models.mjs Seed 34+ models with full data
tools/model-observatory/daily-sync.ts CLI sync tool — manual/ad-hoc model updates from Kie.ai/fal.ai
apps/worker/src/queue/workers/kie-observatory.worker.ts BullMQ automated sync — runs weekly (Sunday 08:00 UTC)
apps/worker/src/services/model-selector.ts Runtime query — bridges DB to pipeline
apps/worker/src/services/kie-gateway.ts Kie.ai API client
apps/web/superseller-site/prisma/schema.prisma AIModel, AIModelRecommendation, AIModelDecision schemas
Installs
1
First Seen
May 18, 2026