UrbanZen is a fully integrated, secure, and fault-tolerant IoT ecosystem designed to transform city infrastructure management in India. It supports multi-utility services such as water, electricity, and transport by combining cutting-edge hardware, AI-powered analytics, secure cloud architecture, and intuitive citizen and administrative interfaces.

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   IoT Devices   │    │    Gateways     │    │  Cloud Backend  │
│                 │◄──►│                 │◄──►│                 │
│ • Water Sensors │    │ • Protocol      │    │ • Microservices │
│ • Smart Meters  │    │   Translation   │    │ • AI/ML Engine  │
│ • Traffic Cams  │    │ • Edge Analytics│    │ • Data Storage  │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                                        │
                       ┌─────────────────┐             │
                       │  User Interface │◄────────────┘
                       │                 │
                       │ • Admin Portal  │
                       │ • Mobile App    │
                       │ • Public APIs   │
                       └─────────────────┘

• Docker & Docker Compose
• Go 1.21+
• Node.js 18+
• Python 3.11+
• kubectl (for Kubernetes deployment)

1. Clone the repository

git clone https://github.com/bhanukaranwal/urbanzen.git
cd urbanzen

2. Start infrastructure services

docker-compose up -d postgres timescaledb mongodb redis kafka

3. Run backend services

make run-services

4. Start frontend applications

# Admin Dashboard
cd frontend/admin-dashboard
npm install && npm start

# Mobile App (development)
cd frontend/mobile-app
flutter pub get && flutter run

5. Access the applications

• Admin Dashboard: http://localhost:3000
• API Documentation: http://localhost:8080/swagger
• Grafana Dashboard: http://localhost:3001

urbanzen/
├── cmd/                    # Main applications
├── internal/               # Private application code
├── pkg/                    # Public library code
├── api/                    # API definitions (OpenAPI/gRPC)
├── web/                    # Web UI assets
├── configs/                # Configuration files
├── scripts/                # Build and deployment scripts
├── deployments/            # Kubernetes manifests
├── docs/                   # Documentation
├── examples/               # Example code and configurations
├── test/                   # Integration tests
├── tools/                  # Supporting tools
├── frontend/               # Frontend applications
│   ├── admin-dashboard/    # React admin interface
│   └── mobile-app/         # Flutter mobile app
├── ml-models/              # Machine learning models
├── iot-devices/            # IoT device simulators
└── monitoring/             # Monitoring configurations

# Build all services
make build

# Run tests
make test

# Deploy to Kubernetes
make deploy

# Generate API documentation
make docs

# Run security scans
make security-scan

# Start IoT device simulators
make simulate-devices

• Real-time flow and quality monitoring
• Automated leak detection and valve control
• Smart billing and fraud prevention
• Predictive maintenance alerts

• Grid monitoring and fault detection
• Demand response and load balancing
• Outage management and restoration
• Energy consumption analytics

• Traffic signal optimization
• Incident detection and response
• Public transport tracking
• Environmental monitoring

• Real-time notifications
• Service request management
• Consumption dashboards
• Multi-language support

• End-to-end encryption (TLS 1.3)
• Hardware security modules (HSM)
• Role-based access control (RBAC)
• Blockchain audit logging
• CERT-IN compliance
• Zero-trust architecture

• Real-time system health monitoring
• Predictive analytics for infrastructure
• Anomaly detection using AI/ML
• Performance metrics and SLA tracking
• Automated alerting and escalation

• India Data Protection Act compliant
• ISO 27001 security standards
• CERT-IN guidelines implementation
• Government procurement standards
• Accessibility standards (WCAG 2.1)

• Architecture Guide
• Security Manual
• API Documentation
• Operations Guide
• Contributing Guidelines

Please read our Contributing Guidelines before submitting pull requests.

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

For support and questions:

• Email: [email protected]
• Documentation: docs.urbanzen.gov.in
• Issue Tracker: GitHub Issues

Made with ❤️ for Smart Cities in India