slashtechno
/
wyzely-detect
mirror of https://github.com/slashtechno/wyzely-detect
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
56 Commits 10 Branches 4 Tags 533 KiB
Python 87.4%
Jupyter Notebook 11.3%
Dockerfile 1.3%
Go to file
slashtechno 4f8e26b2a2
Free up space when building Docker image 		2023-10-15 15:48:36 -05:00
.github/workflows Free up space when building Docker image 2023-10-15 15:48:36 -05:00
.vscode Fix facial recognition 2023-10-14 17:37:42 -05:00
faces Create Deepface Jupyter Notebook 2023-10-13 20:51:16 -05:00
set_detect_notify Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
.Dockerfile.old Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
.dockerignore Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
.gitignore Create Deepface Jupyter Notebook 2023-10-13 20:51:16 -05:00
.python-version Manually plot boxes, rather than using `r.plot()` 2023-10-13 17:44:38 -05:00
Dockerfile Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
LICENSE Change license to GNU GPL v3 2022-12-17 20:38:48 -08:00
README.md Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
deepface-test.ipynb Manage timers in notify.py 2023-10-14 15:40:36 -05:00
docker-compose.yml Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
poetry.lock Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00
pyproject.toml Fixed Docker support and updated README.md 2023-10-14 22:31:48 -05:00

README.md

Set, Detect, Notify

Recognize faces/objects in (Wyze Cam) footage and send notifications to your phone (or other devices)

Features

  • Recognize objects
  • Recognize faces
  • Send notifications to your phone (or other devices) using ntfy
  • Optionally, run headless with Docker
  • Either use a webcam or an RTSP feed

Prerequisites

Poetry/Python

  • Camera, either a webcam or a Wyze Cam
    • All RTSP feeds should work, however.
  • Python
  • Poetry

Docker

  • A Wyze Cam
    • Any other RTSP feed should work, as mentioned above
  • Python
  • Poetry

What's not required

  • A Wyze subscription

Usage

Installation

  1. Clone this repo with git clone https://github.com/slashtechno/wyze-face-recognition.git
  2. cd into the cloned repository
  3. Then, either install with Poetry or run with Docker

Docker

  1. Modify to docker-compose.yml to achieve desired configuration
  2. Run in the background with `docker compose up -d

Poetry

  1. poetry install
  2. poetry run -- set-detect-notify

Configuration

The following are some basic CLI options. Most flags have environment variable equivalents which can be helpful when using Docker.

  • For face recognition, put images of faces in subdirectories ./faces (this can be changed with --faces-directory)
    • Keep in mind, on the first run, face rec
  • By default, notifications are sent for all objects. This can be changed with one or more occurrences of --detect-object to specify which objects to detect
    • Currently, all classes in the COCO dataset can be detected
  • To specify where notifications are sent, specify a ntfy URL with --ntfy-url
  • To configure the program when using Docker, edit docker-compose.yml and/or set environment variables.
  • For further information, use --help

How to uninstall

  • If you used Docker, run docker-compose down --rmi all in the cloned repository
  • If you used Poetry, just delete the virtual environment and then the cloned repository