engine/__init__.py

"""
can-i-run-it — the honest local-AI hardware advisor.

The `engine` package is a *deterministic* compatibility engine. It does the
real arithmetic (memory budgets, what fits, honest trade-offs) with no AI in
the loop, so every number it produces can be inspected and trusted.

A small language model is layered on top *only* to chat and explain — it never
invents the facts. That separation is the whole point: the numbers are math,
the words are plain English.
"""

from .advisor import advise
from .hardware import HardwareSpec

__all__ = ["advise", "HardwareSpec"]

# Bump this whenever the catalogue or rules change. Shown in the UI so people
# know how fresh the advice is — credibility over cleverness.
CATALOGUE_VERSION = "2026-06-07"