Components

This section contains deep, component-level documentation. If you’re new, start with:

• Start here: Start here
• Tutorials: Tutorials

Suite modules

• recsys-service (serving API)
  Integration guide + the canonical API reference.
• recsys-algo (ranking logic)
  Signals, blending, constraints, and determinism notes.
• recsys-pipelines (offline layer)
  Artifacts, scheduling, backfills, and operations runbooks.
• recsys-eval (evaluation)
  Metrics, workflows, CI gates, and experiment analysis.

Layering and contracts

The suite is intentionally layered to keep ownership boundaries clear:

• recsys-algo is the ranking core (no HTTP, no DB).
• recsys-service is serving + tenancy + rules/config.
• recsys-pipelines produces versioned artifacts and a manifest (optional in DB-only mode).
• recsys-eval consumes logs to produce evaluation reports.

If you're choosing an integration shape, start with: Choose your data mode

Read next

• API reference: API Reference
• How it works (mental model): How it works: architecture and data flow