{"id":28506204,"url":"https://github.com/codewithcc/Mpkit_cc","last_synced_at":"2025-07-05T03:31:18.631Z","repository":{"id":286876143,"uuid":"496273613","full_name":"codewithcc/Mpkit_cc","owner":"codewithcc","description":"mpkit-cc - A Python wrapper for MediaPipe that simplifies real-time hand, face, and pose detection. Just pip install mpkit-cc to add computer vision superpowers to your projects with minimal code. Perfect for gesture control, AR apps, and motion tracking.  🔥","archived":false,"fork":false,"pushed_at":"2025-04-08T19:05:16.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-26T01:37:49.503Z","etag":null,"topics":["computer-vision","mediapipe","opencv-python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","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/codewithcc.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":"2022-05-25T14:47:38.000Z","updated_at":"2025-04-08T21:22:58.000Z","dependencies_parsed_at":"2025-04-08T20:22:31.277Z","dependency_job_id":"9f97108d-859a-495d-821c-48b23a72df34","html_url":"https://github.com/codewithcc/Mpkit_cc","commit_stats":null,"previous_names":["codewithcc/mpkit_cc","chexa12cc/mpkit_cc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codewithcc/Mpkit_cc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithcc%2FMpkit_cc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithcc%2FMpkit_cc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithcc%2FMpkit_cc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithcc%2FMpkit_cc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codewithcc","download_url":"https://codeload.github.com/codewithcc/Mpkit_cc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithcc%2FMpkit_cc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263066557,"owners_count":23408387,"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":["computer-vision","mediapipe","opencv-python","python3"],"created_at":"2025-06-08T20:05:04.562Z","updated_at":"2025-07-05T03:31:18.625Z","avatar_url":"https://github.com/codewithcc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MPKIT-CC: Enhanced MediaPipe Toolkit 🚀\n\n[![PyPI Version](https://img.shields.io/pypi/v/mpkit-cc?color=blue\u0026logo=pypi)](https://pypi.org/project/mpkit-cc/)\n[![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/licenses/MIT)\n[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue?logo=python)](https://www.python.org/)\n[![MediaPipe](https://img.shields.io/badge/MediaPipe-FF6F00?logo=mediapipe\u0026logoColor=white)](https://mediapipe.dev/)\n\n**MPKIT-CC** is a powerful Python wrapper that simplifies MediaPipe's computer vision capabilities with real-time FPS monitoring, customizable visualizations, and intuitive APIs for hand tracking, face detection, facial landmarks, and pose estimation.\n\n![Feature Showcase](https://via.placeholder.com/800x450/2d2d2d/ffffff?text=Hand+Tracking+%7C+Face+Mesh+%7C+Pose+Estimation+%7C+Real-time+FPS)\n\n## ✨ Key Features\n\n- **Real-time FPS Monitoring** - Built-in frame rate display with customizable styling\n- **Multi-Feature Detection**:\n  - ✋ Hand tracking with 21 landmarks per hand\n  - 😊 Face detection with bounding boxes\n  - 👁️ 468-point facial mesh detection\n  - 🧍 Full-body pose estimation (33 landmarks)\n- **Custom Visual Styles**:\n  - 🎨 Predefined color constants (RED, GREEN, BLUE, etc.)\n  - 🖌️ Choice between default MediaPipe styles or custom drawings\n  - 🔗 Toggleable landmark connections\n- **Flexible Configuration**:\n  - 📷 Camera settings adjustment (resolution, FPS)\n  - ⚙️ Detection confidence thresholds\n  - 🖼️ Multiple image format support (BGR, RGB, grayscale)\n\n## 📦 Installation\n\n```bash\npip install mpkit-cc\n```\n\n## 🧪 Example Test Code\n\nHere's a complete demonstration showcasing all features of MPKIT-CC with real-time FPS monitoring:\n\n```python\nfrom mpkit_cc import Mptools\nfrom time import time\nfrom cv2 import imshow, waitKey, destroyAllWindows\n\n# Initialize with custom settings\nobj = Mptools(\n    image_mode=False,    # Video stream mode\n    cam_index=0,         # Default camera\n    win_width=640,       # Frame width\n    win_height=360,      # Frame height\n    cam_fps=30,          # Target FPS\n    hand_no=2,           # Detect up to 2 hands\n    face_no=1,           # Detect up to 1 face\n    tol1=0.5,            # Detection confidence\n    tol2=0.5             # Tracking confidence\n)\n\n# Start camera\ncam = obj.init()\nstart_time = time()\n\nwhile cam.isOpened():\n    success, image = cam.read()\n    if not success:\n        print(\"Ignoring empty frame...\")\n        continue\n    \n    # Uncomment the detectors you want to use:\n    \n    # Hand detection with connections (MediaPipe default style)\n    hand_data = obj.find_Hands(\n        image=image,\n        mode=\"BGR\",\n        hand_connection=True,\n        show_detect=True,\n        detection_style=1\n    )\n    \n    # Face detection with bounding box\n    face_data = obj.find_face(\n        image=image,\n        mode=\"BGR\",\n        show_detect=True,\n        boundary=True\n    )\n    \n    # Face mesh with 3D connections\n    face_meshs = obj.find_face_mesh(\n        image=image,\n        mode=\"BGR\",\n        face_connection=True,\n        face_connection_3d=True,\n        show_detect=True\n    )\n    \n    # Pose estimation with custom styling\n    poses = obj.find_pose(\n        image=image,\n        mode=\"BGR\",\n        body_connection=True,\n        show_detect=True,\n        detection_style=0\n    )\n    \n    # Print results if detections found\n    if hand_data and hand_data != ([], [], []):\n        print(f\"Hands detected: {hand_data[1]} (Confidence: {hand_data[2]}%)\")\n    \n    if face_data and face_data != ([], [], []):\n        print(f\"Face detected (Confidence: {face_data[2]}%)\")\n    \n    if face_meshs:\n        print(f\"Face mesh points: {len(face_meshs)} landmarks\")\n    \n    if poses:\n        print(f\"Body pose points: {len(poses)} landmarks\")\n    \n    # Calculate and display FPS\n    end_time = time()\n    fps = int(1 / (end_time - start_time))\n    start_time = end_time\n    image = obj.show_FPS(\n        image=image,\n        mode=\"BGR\",\n        fps_rate=fps,\n        fore_bg=Mptools.YELLOW,\n        back_bg=Mptools.RED\n    )\n    \n    # Display output\n    imshow(\"MPKIT-CC Real-time Detection\", image)\n    \n    # Exit on 'q' key press\n    if waitKey(1) == ord(\"q\"):\n        break\n\n# Cleanup\ncam.release()\ndestroyAllWindows()\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithcc%2FMpkit_cc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodewithcc%2FMpkit_cc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithcc%2FMpkit_cc/lists"}