{"id":30060949,"url":"https://github.com/hiborn4/mrv","last_synced_at":"2025-08-08T01:51:51.576Z","repository":{"id":308603139,"uuid":"1033416410","full_name":"HiBorn4/MRV","owner":"HiBorn4","description":"A complete AI-powered system for real-time monitoring and validation of machine runs via RTSP camera feeds. Includes automated data capture, analysis, and reporting using a powerful frontend in React and backend in FastAPI.","archived":false,"fork":false,"pushed_at":"2025-08-06T19:30:47.000Z","size":62113,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-06T21:19:22.908Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/HiBorn4.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-08-06T19:28:35.000Z","updated_at":"2025-08-06T19:30:50.000Z","dependencies_parsed_at":"2025-08-06T21:32:18.251Z","dependency_job_id":null,"html_url":"https://github.com/HiBorn4/MRV","commit_stats":null,"previous_names":["hiborn4/mrv"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/HiBorn4/MRV","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiBorn4%2FMRV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiBorn4%2FMRV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiBorn4%2FMRV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiBorn4%2FMRV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HiBorn4","download_url":"https://codeload.github.com/HiBorn4/MRV/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiBorn4%2FMRV/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269351896,"owners_count":24402677,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-08-08T01:51:50.329Z","updated_at":"2025-08-08T01:51:51.560Z","avatar_url":"https://github.com/HiBorn4.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛠️ MRV - Machine Runtime Visualizer\n\n![MRV Interface](/public/ui.png)\n![Technical Architecture](/public/mrv.drawio.png)\n\n---\n\n## 📌 What is MRV?\n\n**MRV (Machine Runtime Visualizer)** is an intelligent, real-time monitoring and visualization system built to track machine operations using RTSP camera feeds and advanced analytics. It captures and processes runtime data, extracts meaningful insights, and provides an interactive UI for users to monitor machine health and workflow efficiently.\n\nThis project is particularly suited for **manufacturing units**, **assembly lines**, and **industrial monitoring**, where precision, uptime, and data integrity are critical.\n\n---\n\n## 🎯 Features\n\n- 📹 Real-time camera feed integration (RTSP)\n- 📊 Live plotting of extracted metrics (distance, angle, state, etc.)\n- 📥 CSV logging with timestamp and job tracking\n- 🔄 State reset API logic if values remain constant for \u003e 2 minutes\n- 📁 View and download processed CSV data\n- 📦 Full-stack application (React + FastAPI)\n- 🧠 Smart event triggers for test resets\n- 📈 Insight generation based on captured values\n- 💾 Folder structure management for recordings and analytics\n\n---\n\n## 🚀 Use Cases\n\n- Real-time **production line monitoring**\n- **Maintenance prediction** through sensor/visual data\n- **Quality assurance** via camera-based measurements\n- **Workforce efficiency analytics**\n- Automated alerts when anomalies or stagnation are detected\n\n---\n\n## 🖥️ Frontend Setup (React)\n\n```bash\ncd mrv_frontend\n\nnpm install --legacy-peer-deps --ignore-scripts\n\nnpm install\n\nnpm run dev\n````\n\n\u003e Your frontend will now be live at `http://localhost:5173`\n\n---\n\n## ⚙️ Backend Setup (FastAPI)\n\n```bash\ncd backend\n\npip install -r requirements.txt\n\nuvicorn app:app --reload\n```\n\n* This will start your FastAPI backend which handles:\n\n  * Recordings\n  * CSV generation\n  * API calls\n  * Insights processing\n  * State monitoring\n\n---\n\n## 📦 Additional Backend Scripts\n\nTo serve static files (CSV viewer, download links):\n\n```bash\nuvicorn main:app --reload\n```\n\nFor hardware-connected RTSP video camera streaming and live processing:\n\n```bash\npython live_main.py\n```\n\n\u003e Make sure your camera is connected and RTSP URL is configured properly in the `.env` or config file.\n\n---\n\n## 🎥 Demo (Video walkthrough)\n\nhttps://github.com/user-attachments/assets/48543ee9-8a0b-4548-8e0e-d5ff693d6e1c\n\n---\n\n## 🧠 Insights Logic\n\nWe intelligently monitor the following parameters:\n\n1. ⏱️ **Inactivity Detection:** If machine output values (distance, angle, or state) remain **constant for over 2 minutes**, we auto-trigger a `reset_test` API to ensure fresh test recording.\n2. 🧮 **CSV Analytics:** The backend stores readings as structured CSV logs. These can be viewed, downloaded, or used for further analysis.\n3. 📈 **Real-Time Plotting:** Users can visualize performance as the camera feeds in live metrics.\n\n---\n\n## 🗂️ Folder Structure\n\n```\nMRV/\n├── backend/\n│   ├── app.py\n│   ├── main.py\n│   ├── live_main.py\n│   ├── utils/\n│   └── ...\n├── mrv_frontend/\n│   └── ...\n└── README.md\n```\n\n---\n\n## ✅ Tech Stack\n\n* **Frontend:** React, TailwindCSS, Vite\n* **Backend:** FastAPI, Uvicorn, OpenCV, Pandas\n* **Others:** CSV Logging, Real-time Plotting, RTSP Streaming\n\n---\n\n## 👨‍💻 Author\n\n**Aryan Shirke**\nAI/ML \u0026 Full-Stack Developer\n🔗 [Portfolio](https://aryanshirke.me) • [Upwork](https://www.upwork.com/freelancers/ShirkeAryan) • [GitHub](https://github.com/HiBorn4)\n\n---\n\n## 📬 Want to Collaborate or Deploy MRV?\n\nFeel free to contact me for:\n\n* Custom factory/assembly-line integrations\n* Advanced machine learning-based alerts\n* Enterprise-grade deployment\n\n\u003e 📩 Email: [aryan.shirke@example.com](mailto:aryan.shirke223@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiborn4%2Fmrv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiborn4%2Fmrv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiborn4%2Fmrv/lists"}