Changelog

Track what changed in Hearthlight.

This page mirrors the official `0.8.0` release notes from the Hearthlight main branch and adds a clearly labeled `0.8.1` preview based on the current unreleased work on `main`.

Main Branch Preview

0.8.1

Status: Preview from `main` Version metadata not bumped yet Derived from `main` commits on 2026-05-20 to 2026-05-28

The hosted `main` branch does not contain an official `0.8.1` changelog entry yet. The items below are derived from the current `main` branch commits and runtime files.

  • added a repo-backed Connector Zoo catalog path with local fallback behavior for connector discovery and install flows
  • expanded and clarified the Three Zoos documentation on `main`, including the operator-facing split between models, triggers, and connectors
  • hardened dependency and deployment defaults on the main branch
  • fixed local CPU ingest stalls, status heartbeats, and anomaly gating behavior during runtime recovery

Official Release

0.8.0

Released: 2026-05-15 Source: `CHANGELOG.md` on `main`
  • bumped the project version to `0.8.0` across the Python package, frontend package metadata, macOS bundle metadata, and FastAPI OpenAPI metadata
  • added published-image support for the compose and CLI stack via `HEARTHLIGHT_*_IMAGE` environment variables and a Docker publish helper script
  • widened the default YOLOX detector surface to COCO-trained classes and added extra YOLOX size options in the model zoo
  • migrated the frontend from `react-scripts` to Vite and rebuilt the frontend package lockfile
  • simplified source configuration defaults for blank camera labels, webcam labels, and uploaded video names
  • hid source-level detector, tracker, and anomaly override selectors whenever `Enable Video AI` is turned off while preserving saved disabled state
  • renamed the source save action to `Update Source Settings` and added a visible loading spinner while source settings save
  • expanded local anomaly registry compatibility so `siglip_stage_1_*` and `smolvlm_stage_2_*` defaults resolve even when the external model-zoo catalog is unavailable
  • simplified the Connectors page into a single-column connector list with configured-state badges
  • added per-camera frame skipping with `Process every Nth frame`
  • moved anomaly `1-10` trigger cutoffs out of Stage 2 prompt config and into anomaly detection rules
  • split Rules into separate detection and anomaly sections with multi-camera targeting
  • added processing-rate guidance in the model library and recent measured cadence in Model Logs
  • added third-party Stage 2 anomaly model entries for Chatgpt, Claude, and Lauretta-hosted OpenAI-compatible APIs, with environment-based availability checks and provider model-name overrides
  • moved theme selection into `Settings > Appearance` and persisted it as a workspace-wide backend setting with cached startup restore
  • unified models, triggers, connectors, and rule-set templates under a restart-loaded plugin manifest system backed by persisted plugin bundle and component catalogs
  • added `Govee Light Connection` as a non-core connector plugin that can be pulled from the Connector Zoo without becoming part of the default built-in connector set
  • added Govee connector setup helpers for API-key validation, light-device discovery, optional state inspection, and trigger-driven light control
  • removed stale frontend pages and assets from the retired Control, Entity, and POI flows
  • cleaned up duplicate backup files such as `README (1).md` and `.gitignore (1)`
  • documented the validated detector class surface and clarified that live detector trigger IDs remain normalized to `PERSON` and `BAG`

Source of Truth

Release metadata still lives in the runtime repo.

The official release file is still the main Hearthlight repository changelog. This website page is a readable release surface, not the canonical source for package version metadata.