{"id":28906117,"url":"https://github.com/boda1607/hand_gesture","last_synced_at":"2025-06-24T17:04:20.147Z","repository":{"id":299773743,"uuid":"1004103877","full_name":"Boda1607/Hand_Gesture","owner":"Boda1607","description":"Real-time hand gesture app using MediaPipe + OpenCV with Flask backend and JS frontend for smooth, interactive control.","archived":false,"fork":false,"pushed_at":"2025-06-18T07:43:53.000Z","size":13,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T14:02:56.959Z","etag":null,"topics":["backend","css","cv2","flask","frontend","full-stack","hand-gesture-recognition","html","js","mediapipe","render","response"],"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/Boda1607.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,"zenodo":null}},"created_at":"2025-06-18T06:01:56.000Z","updated_at":"2025-06-18T11:35:07.000Z","dependencies_parsed_at":"2025-06-18T08:42:24.714Z","dependency_job_id":null,"html_url":"https://github.com/Boda1607/Hand_Gesture","commit_stats":null,"previous_names":["boda1607/hand-gesture-app","boda1607/hand_gesture"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Boda1607/Hand_Gesture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boda1607%2FHand_Gesture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boda1607%2FHand_Gesture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boda1607%2FHand_Gesture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boda1607%2FHand_Gesture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Boda1607","download_url":"https://codeload.github.com/Boda1607/Hand_Gesture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boda1607%2FHand_Gesture/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261311657,"owners_count":23139479,"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":["backend","css","cv2","flask","frontend","full-stack","hand-gesture-recognition","html","js","mediapipe","render","response"],"created_at":"2025-06-21T14:02:34.702Z","updated_at":"2025-06-23T16:10:55.949Z","avatar_url":"https://github.com/Boda1607.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖐️ Hand Gesture Recognition Website\n\n---\n\n## Project Description\n\nHand Gesture Recognition is a dynamic and responsive web application designed to help users interact with a system using natural hand movements. Inspired by popular real-time gesture recognition, it leverages **MediaPipe** and **OpenCV** to provide up-to-date information on recognized gestures, detailed visual feedback, and personalized interaction.\n\nUsers can browse content by performing hand gestures, receive real-time updates on detected poses, and curate their own interaction experience. The application is built entirely with vanilla HTML, CSS, and JavaScript on the frontend, powered by a Flask backend, focusing on performance and a smooth user experience.\n\n---\n\n## 💻 Local Demo\n\nYou can explore a local demo of the application by following the setup instructions below:\n\n### To Run the Application Locally:\n1.  **Clone the Repo:**\n    ```bash\n    git clone [https://github.com/Boda1607/hand-gesture-website.git](https://github.com/Boda1607/hand-gesture-website.git)\n    cd hand-gesture-website\n    ```\n2.  **Create a Virtual Environment:**\n    ```bash\n    python -m venv venv\n    source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n    ```\n3.  **Install Dependencies:**\n    ```bash\n    pip install -r requirements.txt\n    ```\n4.  **Run Locally:**\n    ```bash\n    python app.py\n    ```\n    Then open your browser and go to:\n    `http://127.0.0.1:5000/`\n    (Remember to grant camera permissions in your browser.)\n\n---\n\n## 🔧 Features\n\n* **Real-time Hand Tracking:** Discover popular hand poses and movements.\n* **Gesture Recognition:** Filter recognized gestures by various types (e.g., Fist, Open Hand, Thumbs Up, Peace, Heart Gesture).\n* **Dynamic Gesture Toggling:** Sidebar gesture lists can be expanded/collapsed independently, and only one primary category's genres are shown at a time.\n* **Smooth Functionality:** Powerful search to find specific gestures or hand poses by title.\n* **Detailed Content Pages:** View comprehensive details for each detected gesture, including:\n    * Visual representation, confidence, and tracking info.\n    * Key landmark data, processing speed.\n\n---\n\n## 📁 Project Structure\n\n```\nhand-gesture-website/\n├── app.py                     # Main Flask app with MediaPipe + OpenCV\n├── templates/\n│   └── index.html             # Frontend UI\n├── static/\n│   ├── style.css              # Optional styling\n│   └── script.js              # Optional frontend JavaScript\n├── requirements.txt           # Python dependencies\n├── Procfile                   # For deployment (Render)\n└── runtime.txt                # Optional: Python version (e.g., python-3.10.8)\n```\n\n---\n\n## 🌐 Deployment on Render\n\n1.  **Push to GitHub:**\n    Create a repository and push your code to GitHub.\n\n2.  **Go to Render:**\n    Click [New Web Service](https://render.com/dashboard/new/web-service)\n\n    Connect your GitHub repo.\n\n    Set the environment:\n\n    ```yaml\n    Build Command: pip install -r requirements.txt\n    Start Command: python app.py\n    ```\n    Deploy 🎉\n\n---\n\n## ✅ Requirements\n\nSee `requirements.txt`, but key packages include:\n\n* `flask`\n* `opencv-python`\n* `mediapipe`\n* `numpy`\n\n---\n\n## 📝 License\n\nThis project is open source and free to use under the [MIT License](LICENSE).\n\n---\n\n## 🙋‍♂️ Author\n\nAbdElRahman Hesham\nMade with ❤️ using Python, MediaPipe, Flask, and OpenCV.\n\nWebsite: [abdelrahmanz.netlify.app](https://abdelrahmanz.netlify.app)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboda1607%2Fhand_gesture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboda1607%2Fhand_gesture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboda1607%2Fhand_gesture/lists"}