A professional real-time monitoring and control dashboard for fire safety pump room operations. FireTwin provides facilities managers and emergency response teams with comprehensive system monitoring, diagnostics, and AI-powered gauge detection capabilities.

• Real-time Monitoring: Live digital twin visualization of fire safety pump systems
• Multi-Pump Management: Monitor electric, diesel, and jockey pumps simultaneously
• AI-Powered Gauge Detection: Automated pressure gauge reading using computer vision
• System Health Diagnostics: Comprehensive system status and readiness assessments
• Responsive Dashboard: Professional UI optimized for desktop and mobile devices

• Pressure Tracking: Real-time header pressure monitoring (0-12 PSI)
• Fuel Management: Diesel level tracking and consumption analytics
• Water Level Monitoring: Water supply status and capacity alerts
• Battery Health: UPS/backup battery status monitoring
• Run Hours Analytics: Pump runtime tracking for maintenance scheduling

• Pump Control: Toggle and manage pump modes remotely
• System Health Assessment: Automatic evaluation of system readiness
• Fire Readiness Status: Real-time fire response capability status
• Service Tracking: Maintenance history and scheduling
• Efficiency Metrics: Pump efficiency monitoring and diagnostics

FireTwin/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   └── detect-gauge/       # AI gauge detection endpoint
│   │   └── page.tsx                # Main dashboard
│   ├── components/                 # React components
│   ├── lib/
│   │   └── pumpRoomEngine.ts       # Core pump system logic
│   └── styles/                     # Global styles
├── gauge_reader/                   # Python gauge detection module
├── package.json
└── tsconfig.json

• Node.js 18+
• Python 3.8+
• npm or yarn

# Clone the repository
git clone https://github.com/h4ck3r0/FireTwin.git
cd FireTwin

# Install dependencies
npm install

# Install Python dependencies (for gauge detection)
cd gauge_reader
pip install -r requirements.txt
cd ..

# Start development server
npm run dev

# Open browser
# Navigate to http://localhost:3000

# Build the application
npm run build

# Start production server
npm start

npm run lint

FireTwin includes an intelligent gauge reading system using computer vision:

Request:

Content-Type: multipart/form-data
Body: image (File)

Response:

{
  "pressure": 2.5,
  "unit": "PSI",
  "gauge_name": "Laptop Camera",
  "angle_degrees": 45,
  "detection_success": true,
  "timestamp": 1234567890
}

The PumpRoomEngine class manages:

interface PumpRoomState {
  headerPressure: number;      // 0-12 PSI
  dieselLevel: number;          // 0-200 units
  waterLevel: number;           // 0-300 units
  batteryHealth: 'Healthy' | 'Low' | 'Critical';
  electricPump: PumpStatus;
  dieselPump: PumpStatus;
  jockeyPump: PumpStatus;
  fireReadiness: 'READY' | 'NEEDS_ATTENTION' | 'CRITICAL';
  systemHealth: 'HEALTHY' | 'WARNING' | 'CRITICAL';
}

• setHeaderPressure(pressure) - Update system pressure
• setDieselLevel(level) - Update fuel level
• setWaterLevel(level) - Update water supply
• setBatteryHealth(health) - Update battery status
• togglePump(pump) - Control pump mode
• evaluateStatus() - Auto-assess system health

• Fire safety pump system with accessible gauges
• Camera or gauge reading device
• Network connectivity for real-time data
• Backup power (UPS/Battery system)

• Modern web browser (Chrome, Firefox, Safari, Edge)
• Screen resolution: 1024x768 minimum
• Internet connection for data synchronization

• Critical Alert System: Immediate notifications for system faults
• Battery Health Monitoring: UPS backup power verification
• Pressure Validation: Safe operating range enforcement (0-12 PSI)
• Fuel Level Alerts: Low diesel warnings
• System Lockout: Safety mechanisms for anomalies

• 🟢 READY: System operational and ready for fire response
• 🟡 NEEDS_ATTENTION: Minor issues require attention
• 🔴 CRITICAL: System requires immediate maintenance

• 🟢 HEALTHY: All systems operational
• 🟡 WARNING: One or more non-critical issues
• 🔴 CRITICAL: System malfunction detected

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

h4ck3r0 - GitHub Profile

For issues, questions, or suggestions, please open an Issue on GitHub.

• Mobile app (React Native)
• Historical data analytics and reporting
• Multi-site monitoring dashboard
• SMS/Email alert notifications
• Machine learning predictive maintenance
• Integration with building management systems (BMS)

Last Updated: June 2026
Version: 1.0.0