An interactive digital twin for monitoring urban air quality. From open data to actionable insights.
🌐 View Live Demo (MVP) · 📈 Roadmap · 📖 About
Ufa Air Digital Twin is a web-based platform designed to democratize access to environmental data. It solves the problem of fragmented official data (published in PDFs and unreadable tables) by aggregating, normalizing, and visualizing it on an interactive map with a clear Air Quality Index (AQI).
This project started as a research initiative and has evolved into a commercial startup, having won the "Student Startup 2026" grant (RUB 1,000,000) from the Russian Federation.
The platform is designed for:
- Authorities (B2G): Operational monitoring and decision-making support.
- Citizens (B2C): Real-time air quality information for health-conscious living.
- Industry (B2B): Environmental auditing and background pollution control.
- Interactive GIS Map: Real-time visualization of monitoring stations with color-coded AQI indicators.
- Aggregated AQI: Custom Air Quality Index calculation adapted to Russian MPC (Maximum Permissible Concentrations).
- Data Transparency: Display of raw concentration data for 11 pollutants across 9 monitoring stations in Ufa.
- Responsive UI: Built with React and TypeScript for a smooth user experience.
This project is currently an MVP. The roadmap reflects the development plan for the next 12 months, aligning with the grant objectives.
| Phase | Focus | Status / Timeline | Key Deliverables |
|---|---|---|---|
| Phase 1 | Data Infrastructure | ✅ Completed (R&D) | Data models designed; PostgreSQL/EF Core architecture prepared. |
| Phase 2 | Data Ingestion | 🚧 In Progress | Development of automated C# parsers for Roshydromet, Ministry of Ecology, and Rospotrebnadzor. |
| Phase 3 | Backend & API | 📅 Q3-Q4 2026 | RESTful API (FastAPI/Node.js) integration; Full database migration to the cloud (Yandex Cloud / AWS). |
| Phase 4 | AI & Predictive Analytics | 📅 Q1 2027 | Integration of ML models (LSTM/GBM) for 72-hour air quality forecasting. |
| Phase 5 | Commercial Launch | 📅 Q2 2027 | Full B2G product release. Licensing to regional ministries. |
- Frontend: React (TypeScript), Vite, Leaflet
- Backend (Planned): Python (FastAPI) / C# .NET 8
- Database (Planned): PostgreSQL (with TimescaleDB extension)
- Data Parsing (Developed): C# .NET 8, HtmlAgilityPack
- Deployment: GitHub Pages (Frontend), Yandex Cloud / VPS (Backend)
ufa-air-digital-twin/
├── README.md # This file
├── LICENSE # CC BY-NC-ND 4.0
├── index.html # Entry point
├── /src/ # React/TypeScript application
│ ├── /components/ # UI components (Map, Sidebar, Charts)
│ ├── /data/ # Static mock data for MVP (to be replaced)
│ └── /utils/ # AQI calculation and helpers
├── /backend/ # (Coming Soon) Data Parsers & API
│ └── /Parsers/ # C# .NET 8 console apps (Roshydromet source)
└── package.json
To run this MVP on your local machine:
- Clone the repo:
git clone https://github.com/bat801/ufa-air-digital-twin.git
- Install dependencies:
npm install
- Run the dev server:
npm run dev
- Open
http://localhost:5173to view it in the browser.
This project is not open-source in the traditional sense. It is a commercial product currently under active development.
- Source Code: Published under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0) license.
- ✅ You may view, fork, and study the code for educational/portfolio purposes.
- ❌ Commercial use, distribution, or creation of derivative works is strictly prohibited without explicit written permission.
- Patent Status: The core algorithmic approach and data aggregation methods are being prepared for registration (Patent pending).
- Author: Batyr Nuriev
- Role: Founder & Lead Developer
- Specialization: GIS Engineering | AR/VR Development | Full-Stack Environmental Tech
- Email: bat2003@mail.ru
- GitHub: @bat801