🏢 AI-Powered Smart Building Crowd Intelligence System

A full-stack Smart Building platform that simulates, visualizes, and analyzes crowd movement in real time to improve occupancy management, safety monitoring, and operational efficiency inside large facilities.

---

📸 Screenshots

Dashboard

Building Visualizer

Building Builder

Live Crowd Heatmap

---

📖 Overview

Managing thousands of people inside malls, hospitals, schools, airports, offices, hotels, and public buildings is challenging. Overcrowding, congestion, and inefficient movement can reduce operational efficiency and create safety concerns.

This project provides an AI-powered Smart Building Crowd Intelligence System that creates a digital twin of a building and continuously visualizes crowd movement through an interactive dashboard.

The platform enables administrators to monitor occupancy levels, visualize crowd density using heatmaps, identify congestion hotspots, manage building capacity, and support smarter operational decisions through real-time analytics.

---

✨ Key Features

• 🏢 Multi-building management
• 🗺️ Interactive floor-plan visualization
• 👥 Real-time crowd simulation
• 📊 Live occupancy monitoring
• 🔥 Dynamic crowd heatmaps
• 📈 Zone-wise occupancy analytics
• 🚪 Entry & Exit point management
• 🎯 Capacity threshold monitoring
• ⚡ Interactive dashboard
• 🛠️ Building Builder for creating floor layouts
• 🔄 Live crowd simulation controls
• 📡 REST API powered by FastAPI

---

🌍 Real-World Applications

This platform can be adapted for multiple environments, including:

🏫 Schools & Universities

• Monitor crowded corridors
• Identify high-density gathering areas
• Improve campus safety
• Support emergency evacuation planning

🛍 Shopping Malls

• Track visitor movement
• Detect congestion hotspots
• Optimize customer flow
• Improve shopping experience

🏥 Hospitals

• Monitor waiting areas
• Manage patient flow
• Improve operational efficiency

✈️ Airports & Railway Stations

• Passenger movement analytics
• Queue monitoring
• Crowd visualization
• Capacity management

🏢 Corporate Offices

• Workspace occupancy monitoring
• Floor utilization analysis
• Space optimization

🏟 Stadiums & Event Venues

• Crowd monitoring
• Occupancy visualization
• Emergency planning
• Entry & Exit management

---

🏗️ System Architecture

                    React + TypeScript
                            │
                            ▼
                    FastAPI REST API
                            │
                            ▼
                   SQLAlchemy ORM
                            │
                            ▼
                      SQLite Database
                            │
                            ▼
                 Crowd Simulation Engine
                            │
                            ▼
          Interactive Heatmap & Analytics Dashboard

---

🛠️ Tech Stack

Frontend

• React 19
• TypeScript
• Vite
• Tailwind CSS
• React Query (TanStack Query)
• Zustand
• Lucide React Icons

Backend

• FastAPI
• Python
• SQLAlchemy

Database

• SQLite

Visualization

• SVG Canvas Rendering
• Interactive Heatmaps
• Layered Floor Plans

---

🚀 Getting Started

Prerequisites

Install the following software:

• Python 3.10+
• Node.js 18+

Verify installation:

python --version
node --version
npm --version

---

🚀 Installation (Windows)

Backend

cd backend

python -m venv venv

venv\Scripts\activate

pip install -r requirements.txt

python -m uvicorn main:app --host 0.0.0.0 --port 8000

---

Frontend

cd frontend

npm install

npm run dev

Open

http://localhost:5173

Backend API

http://localhost:8000

Swagger Documentation

http://localhost:8000/docs

---

📂 Project Structure

smart-building-visualizer/
│
├── backend/
│   ├── main.py
│   ├── simulator.py
│   ├── crowd_flow_engine.py
│   ├── crowd_particles.py
│   ├── database.py
│   ├── models.py
│   ├── schemas.py
│   ├── defaults.py
│   ├── seed.py
│   └── requirements.txt
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── api/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── pages/
│   │   ├── store/
│   │   ├── assets/
│   │   ├── types/
│   │   ├── App.tsx
│   │   └── main.tsx
│   │
│   ├── package.json
│   └── vite.config.ts
│
├── scripts/
│
├── README.md
│
└── .gitignore

---

🖥️ Application Modules

📊 Dashboard

• View all buildings
• Live occupancy statistics
• Building cards
• Building management table
• Search & Filter

---

🗺️ Building Visualizer

• Interactive floor selection
• Zone visualization
• Live heatmap
• Crowd simulation
• Zoom & Pan
• Live occupancy updates

---

🏗️ Building Builder

• Create new buildings
• Draw floor layouts
• Create zones
• Add entities
• Configure Entry & Exit points
• Edit occupancy settings

---

📈 Crowd Simulation

The application includes a crowd simulation engine that updates occupancy values automatically.

Simulation includes:

• Live occupancy updates
• Capacity-aware movement
• Entry & Exit balancing
• Zone occupancy tracking
• Pause / Resume simulation

---

📡 REST API

Interactive Swagger Documentation is available at

http://localhost:8000/docs

---

📸 Screenshots

(Add screenshots here after deployment.)

Example:

• Dashboard
• Building Builder
• Building Visualizer
• Live Crowd Heatmap

---

🔮 Future Enhancements

• AI-powered anomaly detection
• Predictive crowd analytics
• IoT sensor integration
• CCTV integration
• Computer Vision support
• Emergency alert system
• Multi-user authentication
• Cloud deployment
• Mobile application

---

👨‍💻 Author

Animesh Singh

GitHub

https://github.com/Animeishhh

---

⭐ If you found this project interesting, consider giving it a Star!