# BrandonJoffe/home_surveillance

Home surveillance system with facial recognition

Repository: https://github.com/BrandonJoffe/home_surveillance
Canonical: https://ross.abutalabs.com/products/home_surveillance
Language: HTML
License Family: other
Last push: 2022-11-22T01:11:36+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3684, "days_push": 1381, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1259, forks 383 (observed 2026-08-28T04:04:09.882107+00:00)

## What it is
A self-hosted home surveillance application that processes streams from multiple IP cameras, performs motion detection and facial recognition (via Openface and an SVM classifier), and alerts users to potential intruders. It includes a web dashboard built with Flask/SocketIO and a Raspberry Pi GPIO interface for integrating with existing wired alarm panels.

## Use cases
- identify known family members vs intruders on home cameras
- send alerts when an unrecognized face appears on an IP camera
- integrate facial recognition with an existing wired alarm system
- stream and monitor multiple IP cameras from a web dashboard
- build a low-cost DIY smart security system with a Raspberry Pi

## When to choose
- you want a self-hosted, low-cost surveillance system with face recognition
- you have IP cameras and want to distinguish known people from strangers
- you want to hook camera-based alerts into an existing alarm panel via Raspberry Pi GPIO

## When to avoid
- you need a actively maintained project with recent updates and support
- you need a license permitting commercial use (the repo has no license)
- you need production-grade, scalable video analytics rather than a hobbyist system

## Facets
- artifact type: application
- maturity: maintenance
- function: computer-vision, image-processing, video-processing, machine-learning, web-framework, alerting, security
- domain: computer-vision, security, iot, self-hosted
- platform: python, self-hosted
- tags: facial-recognition, surveillance, ip-cameras, motion-detection, raspberry-pi, openface, home-security, alarm-system, home-automation, linux, web-server

## Member repositories
- BrandonJoffe/home_surveillance (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:09.882107+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:05:27.783219+00:00, confidence not recorded.
  - readme: https://github.com/BrandonJoffe/home_surveillance (fetched 2026-08-28T04:04:09.882107+00:00, sha 67cc3ec3d20e)
- Data as of 2026-08-30T08:39:29.467469+00:00.