Speculo is an open source platform that utilizes a Deep Convolution Inverse Graphics Network for indexing faces found in a video footage, specifically for CCTV surveillance. It allows you to browse through these footages by the faces found in them rather than thousands of frames. The key differentiator between regular face recognition software and Speculo is that Speculo can recognize faces in different angles.
- React
- Python 3.8
- Docker
- NodeJS
- OpenCV
- MongoDB
git clone https://github.com/mrsupiri/speculo/tree/master
Speculo uses MongoDB as the database therefore create a file called database_config.env in the root folder and add the following environment variables;
- DB_NAME
- DB_USERNAME
- DB_PASSWORD
- DB_HOST
Use --build only when you run it for the first time or if you have made changes to the code
docker-compose up --build
If you want to contribute to Speculo, be sure to review the guidelines in CONTRIBUTING.md.
Here are the links to pages that explain the system in detail.