Detector
The detector model decides which raw classes are visible for each source and which class metadata can feed alert-rule options.
Model Library
Choose the models your runtime uses.
Hearthlight’s Model Zoo feeds the mounted inventory and the stage bindings used at runtime. It exists so operators can change model selection without turning that choice into brittle one-off config edits.
Stage Coverage
detect, track and identify behavior
The current repository describes the Model Zoo as the source for detector, tracker, heuristic filter, and anomaly detection options.
Tracker
Trackers maintain continuity between frames so the runtime can pass stable motion and entity context downstream.
Heuristic Filter
Filtering stages refine or gate runtime behavior before later steps consume those signals.
Anomaly Detection
Local and API-backed anomaly stages can surface higher-level activity and object events after the earlier runtime stages finish their work.
Selection Rules
Bindings resolve per source.
Hearthlight resolves the effective runtime model set in a stable order: a source-specific override wins first, then the saved default binding for that stage.
Built-in, mounted, and future plugin models
The current docs describe built-in models, third-party API-backed models such as Chatgpt and Claude, and future external plugin models that can appear after restart.
Operator Experience
The library exists for readable choices, not raw registry spelunking.
Hearthlight keeps stable internal keys for storage and automation while presenting readable display names in the operator-facing surfaces.
Inspect the current inventory
Use the CLI to list templates and model options before startup.
hearthlight list-modelsMount models during onboarding
The onboarding flow can seed the mounted inventory with default models or specific registry keys through repeated `--mount-model` flags.
Contribute
Expand the model surface responsibly.
Contributions can target the runtime’s registry-backed model flow or the dedicated model-zoo repository, depending on whether you are adding catalog coverage or model assets.