{"id":17340849,"url":"https://github.com/isala404/speculo","last_synced_at":"2025-08-31T16:33:33.841Z","repository":{"id":38997491,"uuid":"241639567","full_name":"isala404/speculo","owner":"isala404","description":"Realtime face detection and recognition using deep learning","archived":false,"fork":false,"pushed_at":"2023-01-24T02:23:49.000Z","size":81072,"stargazers_count":24,"open_issues_count":66,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-14T19:07:35.629Z","etag":null,"topics":["data-science","face-recognition","faces","footages","opencv","python3","reactjs","speculo","surveillance","tensorflow","typescript"],"latest_commit_sha":null,"homepage":"http://speculo.isala.me/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/isala404.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-19T14:16:40.000Z","updated_at":"2024-04-14T09:18:17.000Z","dependencies_parsed_at":"2023-02-13T12:01:12.345Z","dependency_job_id":null,"html_url":"https://github.com/isala404/speculo","commit_stats":null,"previous_names":["isala404/speculo"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isala404%2Fspeculo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isala404%2Fspeculo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isala404%2Fspeculo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isala404%2Fspeculo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isala404","download_url":"https://codeload.github.com/isala404/speculo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248943456,"owners_count":21186958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-science","face-recognition","faces","footages","opencv","python3","reactjs","speculo","surveillance","tensorflow","typescript"],"created_at":"2024-10-15T15:46:46.055Z","updated_at":"2025-04-14T19:07:44.201Z","avatar_url":"https://github.com/isala404.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# speculo - Surveillance done smart\n\n[![CodeFactor](https://www.codefactor.io/repository/github/mrsupiri/speculo/badge?s=a75918dd8d73cd4933b6858e455efad553dcd7c9)](https://www.codefactor.io/repository/github/mrsupiri/speculo) ![CI/CD Pipeline](https://github.com/mrsupiri/speculo/workflows/CI/CD%20Pipeline/badge.svg)\n\nSpeculo 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.\n \n## Prerequisites\n\n- React\n- Python 3.8\n- Docker\n- NodeJS\n- OpenCV\n- MongoDB\n\n## Development Setup\n\n#### Clone the Project\n\n```git clone https://github.com/mrsupiri/speculo/tree/master```\n\n#### Add the database configuration\n\nSpeculo uses MongoDB as the database therefore create a file called `database_config.env` in the root folder and add the following environment variables;\n```\n- DB_NAME\n- DB_USERNAME\n- DB_PASSWORD\n- DB_HOST\n```\n#### Run it\n\n\u003e Use --build only when you run it for the first time or if you have made changes to the code\n\n```docker-compose up --build```\n\n## How to contribute?\n\nIf 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).\n\n## Resources\n\nHere are the links to pages that explain the system in detail.\n\n- [Speculo: Project Modules explained in depth](https://github.com/mrsupiri/speculo/wiki/Project-Components)\n- [Speculo: Project Structure](https://github.com/mrsupiri/speculo/wiki/Project-Structure)\n\n## License\n[MIT](https://github.com/mrsupiri/speculo/blob/documentation/readme-rewrite/LICENSE.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisala404%2Fspeculo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisala404%2Fspeculo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisala404%2Fspeculo/lists"}