Core profile

Awareness Core

Home awareness automation core for camera, doorbell, entry-sensor, snapshot, notification, and Redis-backed event history workflows across enabled integrations.

Home awareness engine v4.12.1 6 settings Awareness engine
Core role

What this core is for

Home awareness engine

Highlights

Behavior in the current codebase

  • Replaces the old HA automations bridge with an in-core awareness runtime.
  • Builds camera, doorbell, motion, and entry-sensor options from enabled integration device capabilities.
  • Existing rules that reference unavailable integrations report the missing integration/device until the provider is downloaded and enabled.
  • Stores newest-first events in Redis with source area context, timestamps, and metadata for later querying.
  • Camera and doorbell paths support snapshot + vision summaries, with optional notifications, display cards, and TTS routing.
  • Entry sensors log both open and closed events, with open-only notifications and optional open-only TTS.
  • The old Home Assistant-oriented brief system has moved out of Awareness Core; the Tater Dashboard now generates cached 12-hour awareness summaries from the Redis event timeline.
  • Snapshot notification paths can send recent camera images and descriptions to Tater S3Box displays through the display event API.
Related Verbas

Direct core support

This runtime component mainly handles orchestration rather than exposing its own direct Verba target.

Settings

Configuration schema

  • Camera Event Clip Length (sec) number

    Length of short camera clips sent to the configured Video Understanding model.

    Key: camera_event_clip_seconds Default: 8
  • Event Clip Max Size (MB) number

    Maximum video size to retain for each Awareness event.

    Key: event_clip_max_mb Default: 32
  • Snapshot Max Size (KB) number

    Maximum JPEG size to store per event snapshot.

    Key: event_snapshot_max_kb Default: 768
  • Events Retention select

    How long to retain awareness events written to Redis.

    Key: events_retention Default: 7d Options: 2d, 7d, 30d, forever
  • Store Event Clips checkbox

    Keep successful camera and sensor-linked clips so they can be played from Event History.

    Key: store_event_clips Default: True
  • Store Event Snapshots checkbox

    Store camera, doorbell, and sensor-linked snapshots for Event History.

    Key: store_event_snapshots Default: True