first commit

readme.md

@@ -0,0 +1,40 @@
+# Desk Presence Detection (Snapshot-Based, Home Assistant)
+
+This project provides a low-CPU desk presence detection system using a webcam and snapshot-based computer vision. It is designed to work reliably on weak hardware without running continuous video inference.
+
+Presence is detected using:
+
+- Face detection (Haar cascade)
+- Frame-to-frame motion detection
+- A confidence score with decay
+- A cooldown to prevent feedback loops caused by lights turning on or off
+- The detected presence is published to Home Assistant as a binary_sensor.
+
+## Installation
+
+### 1. Clone
+
+### 2. Build the image
+
+```sh
+docker build -t desk-presence .
+```
+
+### 3. Home Assistant Setup
+
+#### A. Create Long Lived Access Token
+
+#### B. Run the container
+
+```sh
+docker run -d \
+  --name desk-presence \
+  --restart unless-stopped \
+  --device /dev/video0:/dev/video0 \
+  -e HA_URL="http://192.168.0.202:8123" \
+  -e HA_ENTITY_ID="binary_sensor.desk_presence_vision" \
+  -e HA_TOKEN="YOUR_LONG_LIVED_TOKEN" \
+  -e CAMERA="/dev/video0"
+  desk-presence
+
+```