{"id":19075064,"url":"https://github.com/aleko-khomasuridze/tello_face_recognition","last_synced_at":"2026-04-29T14:36:24.762Z","repository":{"id":205829408,"uuid":"715198530","full_name":"aleko-khomasuridze/TELLO_FACE_RECOGNITION","owner":"aleko-khomasuridze","description":"python program that utilizes DJI Tello's camera with OpenCV and Tello python module and adds a layer of face recognition to it","archived":false,"fork":false,"pushed_at":"2024-07-11T08:21:43.000Z","size":848,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-02T17:49:57.294Z","etag":null,"topics":["algorithms","face-detection","face-recognition","opencv","python","tello-drone"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aleko-khomasuridze.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-06T17:00:01.000Z","updated_at":"2024-09-02T14:06:57.000Z","dependencies_parsed_at":"2025-01-02T17:46:33.447Z","dependency_job_id":"908ef427-b23c-4313-8211-8a69f62149ce","html_url":"https://github.com/aleko-khomasuridze/TELLO_FACE_RECOGNITION","commit_stats":null,"previous_names":["aleko-khomasuridze/tello_face_recognition"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleko-khomasuridze%2FTELLO_FACE_RECOGNITION","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleko-khomasuridze%2FTELLO_FACE_RECOGNITION/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleko-khomasuridze%2FTELLO_FACE_RECOGNITION/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleko-khomasuridze%2FTELLO_FACE_RECOGNITION/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aleko-khomasuridze","download_url":"https://codeload.github.com/aleko-khomasuridze/TELLO_FACE_RECOGNITION/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240127090,"owners_count":19751938,"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":["algorithms","face-detection","face-recognition","opencv","python","tello-drone"],"created_at":"2024-11-09T01:53:15.070Z","updated_at":"2026-04-29T14:36:19.741Z","avatar_url":"https://github.com/aleko-khomasuridze.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#TELLO FACE DETECTION\n\n![Project Image](project_image.jpg)\n\n## Table of Contents\n- [Introduction](#introduction)\n- [Key Features](#key-features)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Usage](#usage)\n- [Customization](#customization)\n- [Contributing](#contributing)\n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n## Introduction\n\nThis project combines real-time face detection and annotation using the OpenCV library with the control of a DJI Tello drone. The integrated system captures video from a specified camera, detects faces in each frame, and adds various annotations to the detected faces, such as outlines, crosshairs, and labels. Additionally, it provides drone control capabilities to react to face movements.\n\nKey elements of the project include:\n- Face detection using Haar Cascade classifiers.\n- Annotation of detected faces with frames, labels, and center points.\n- Visualization of the drone's battery status.\n- Drone control based on face position (commented out by default for safety).\n\n## Key Features\n\n- Real-time face detection in video streams.\n- Annotation of detected faces for visualization.\n- Integration with DJI Tello drone for controlling its movement.\n- Battery status display.\n- Highly customizable to adapt to specific use cases.\n\n## Getting Started\n\n### Prerequisites\n\nTo run this project, you'll need the following prerequisites:\n\n- Python 3.x\n- OpenCV (cv2)\n- NumPy\n- DJITelloPy (for drone control)\n\n### Installation\n\n1. Clone the repository to your local machine:\n\n   ```bash\n   git clone https://github.com/yourusername/face-detection-drone-control.git\n   ```\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd face-detection-drone-control\n   ```\n\n3. Install the required dependencies using pip:\n\n   ```bash\n   pip install opencv-python numpy djitellopy\n   ```\n\n## Usage\n\n1. Ensure that the DJI Tello drone is connected and powered on.\n2. Make sure the Haar Cascade XML file (\"haarcascade_frontalface_default.xml\") is present in the specified directory.\n3. Run the project:\n\n   ```bash\n   python main.py\n   ```\n\n4. The system will start capturing video from the specified camera (camera index can be adjusted in the code).\n\n## Customization\n\n- To customize the behavior of the drone based on face position, uncomment and modify the relevant code section in the script.\n- You can adjust the appearance of face annotations, labels, and frames by modifying the color and size parameters in the code.\n- Explore the `faceDraw` class for more customization options.\n\n## Contributing\n\nContributions to this project are welcome! Feel free to open issues, submit pull requests, or provide suggestions for improvements.\n\n## License\n\nThis project is unlicensed and is considered to be in the public domain. You are free to use, modify, and distribute it without any legal restrictions. However, keep in mind that this means there are no warranties or guarantees associated with the project. Use it at your own discretion and responsibility.\n\n\n## Acknowledgments\n\n- Special thanks to Aleko Khomasuridze for the original code and idea.\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faleko-khomasuridze%2Ftello_face_recognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faleko-khomasuridze%2Ftello_face_recognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faleko-khomasuridze%2Ftello_face_recognition/lists"}