Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/isala404/speculo
Realtime face detection and recognition using deep learning
https://github.com/isala404/speculo
data-science face-recognition faces footages opencv python3 reactjs speculo surveillance tensorflow typescript
Last synced: 4 months ago
JSON representation
Realtime face detection and recognition using deep learning
- Host: GitHub
- URL: https://github.com/isala404/speculo
- Owner: isala404
- License: mit
- Created: 2020-02-19T14:16:40.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T02:23:49.000Z (about 2 years ago)
- Last Synced: 2024-04-13T04:47:30.349Z (10 months ago)
- Topics: data-science, face-recognition, faces, footages, opencv, python3, reactjs, speculo, surveillance, tensorflow, typescript
- Language: Jupyter Notebook
- Homepage: http://speculo.isala.me/
- Size: 77.3 MB
- Stars: 23
- Watchers: 5
- Forks: 3
- Open Issues: 66
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# speculo - Surveillance done smart
[](https://www.codefactor.io/repository/github/mrsupiri/speculo) 
Speculo is an open source platform that utilizes a [Deep Convolution Inverse Graphics Network](https://www.microsoft.com/en-us/research/publication/deep-convolutional-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.
## Prerequisites
- React
- Python 3.8
- Docker
- NodeJS
- OpenCV
- MongoDB
## Development Setup
#### Clone the Project
```git clone https://github.com/mrsupiri/speculo/tree/master```
#### Add the database configuration
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
```
#### Run it
> Use --build only when you run it for the first time or if you have made changes to the code
```docker-compose up --build```
## How to contribute?
If you want to contribute to Speculo, be sure to review the guidelines in [CONTRIBUTING.md](https://github.com/mrsupiri/speculo/blob/documentation/readme-rewrite/CONTRIBUTING.md).
## Resources
Here are the links to pages that explain the system in detail.
- [Speculo: Project Modules explained in depth](https://github.com/mrsupiri/speculo/wiki/Project-Components)
- [Speculo: Project Structure](https://github.com/mrsupiri/speculo/wiki/Project-Structure)
## License
[MIT](https://github.com/mrsupiri/speculo/blob/documentation/readme-rewrite/LICENSE.md)