Shaoza1/lesotho-vision-suite

# 🏔️ MalotiTracker **Real-Time Color-Based Object Tracking for Lesotho Contexts** MalotiTracker is a robust computer vision application designed specifically for Lesotho's unique environments - from highland vegetation monitoring to urban traffic analysis. Built with React, Supabase, and designed for seamless Python/OpenCV integration. --- ## 📋 Table of Contents 1. Features 2. Quick Start 3. Architecture Overview 4. Production Deployment 5. Replacing Mock Data with Real Data 6. Python Backend Integration 7. WebSocket Streaming 8. Database Configuration 9. Lesotho-Specific Presets 10. Field Testing Protocol 11. Privacy & Ethics 12. API Reference 13. Contributing --- ## ✨ Features ### Core Tracking Features - **Interactive HSV Color Tuning** - Real-time sliders for hue, saturation, and value ranges - **Movement Tracking** - Track object centroids across video frames - **Velocity Estimation** - Calculate pixel velocity (dx/dt, dy/dt) with km/h conversion - **Kalman Filter Smoothing** - Smooth position tracking for stable readings - **Area Filtering** - Ignore small noise with tunable minimum area - **Distance Restrictions** - Filter objects beyond configurable pixel distances - **Monocular Distance Estimation** - Approximate real-world distances using focal length calibration ### Lesotho-Specific Features - **Highland Vegetation Monitoring** - Track green/brown colors for drought detection - **Basotho Pony Tracking** - Pre-configured for tracking livestock in rural areas - **Urban Traffic Analysis** - Vehicle and pedestrian tracking for Maseru - **Wildlife Conservation** - Species tracking in Sehlabathebe National Park - **Cultural Element Detection** - Track Mokorotlo hats and traditional elements - **Terrain-Aware Calibration** - Adjust for Lesotho's mountainous topography ### Technical Features - **Real-Time WebSocket Streaming** - Low-latency video processing - **Sesotho/English Language Support** - Full internationalization - **Mobile-Responsive Desi …