Powered by Liveupx.com & xHost
Built for students, developers, and traffic engineering enthusiasts
Features · Screenshots · Quick Start · Documentation · Contributing
This is a fully functional, cross-platform traffic management system built entirely in Python. It simulates real-world traffic flow at multiple intersections, uses adaptive algorithms to dynamically adjust signal timing, detects congestion, prioritizes emergency vehicles, and provides a beautiful real-time GUI dashboard — all with zero external dependencies (only Python standard library).
Perfect for:
- 🎓 College students — capstone projects, traffic engineering coursework, simulation studies
- 💻 Python learners — real-world application of OOP, threading, GUI development, algorithms
- 🔬 Researchers — extensible base for traffic optimization experiments and ML integration
- 🏗️ Developers — clean architecture patterns, event-driven design, adaptive algorithms
| Feature | Description |
|---|---|
| 🔄 Adaptive Signal Timing | Dynamically adjusts green phase duration based on real-time queue density |
| 🏙️ Multi-Intersection | Manage multiple independent intersections simultaneously |
| 🚑 Emergency Priority | Automatic signal override when emergency vehicles are detected |
| 📊 Live Statistics | Real-time queue length, vehicles passed, average wait time per direction |
| Configurable threshold-based alerts with event logging | |
| 🎨 Dark Theme Dashboard | Beautiful Tkinter GUI with intersection visualization |
| 📋 CSV Export | Export all traffic events for offline analysis in Excel/pandas |
| 🔌 Event-Driven Architecture | Pub/sub callbacks for easy extensibility |
| ⚙️ Configurable | All parameters tunable via config.py |
| 🖥️ Cross-Platform | Works on Windows, macOS, and Linux |
The primary interface showing real-time intersection visualization, traffic signals, vehicle queues, live statistics, and event log.
When an emergency vehicle is detected, the system automatically overrides signals to provide priority passage.
Real-time monitoring flags lanes that exceed the congestion threshold, with color-coded alerts.
Export detailed traffic event logs for analysis in Excel, Google Sheets, or pandas.
Clean layered architecture separating presentation, logic, data, and infrastructure.
- Python 3.9+ (with Tkinter)
- No other dependencies required!
🪟 Windows
# 1. Install Python from python.org (check "Add to PATH")
# 2. Clone the repo
git clone https://github.com/liveupx/Python-Based-Traffic-Management-System.git
cd Python-Based-Traffic-Management-System
# 3. Run
python traffic_management_system.py🍎 macOS
# 1. Install Python (if not already installed)
brew install python-tk@3.12
# 2. Clone the repo
git clone https://github.com/liveupx/Python-Based-Traffic-Management-System.git
cd Python-Based-Traffic-Management-System
# 3. Run
python3 traffic_management_system.py🐧 Linux (Ubuntu/Debian)
# 1. Install Python and Tkinter
sudo apt update
sudo apt install python3 python3-tk
# 2. Clone the repo
git clone https://github.com/liveupx/Python-Based-Traffic-Management-System.git
cd Python-Based-Traffic-Management-System
# 3. Run
python3 traffic_management_system.py🐧 Linux (Fedora/RHEL)
# 1. Install Python and Tkinter
sudo dnf install python3 python3-tkinter
# 2. Clone the repo
git clone https://github.com/liveupx/Python-Based-Traffic-Management-System.git
cd Python-Based-Traffic-Management-System
# 3. Run
python3 traffic_management_system.py🐧 Linux (Arch)
# 1. Install Python and Tkinter
sudo pacman -S python tk
# 2. Clone the repo
git clone https://github.com/liveupx/Python-Based-Traffic-Management-System.git
cd Python-Based-Traffic-Management-System
# 3. Run
python3 traffic_management_system.py- Launch the application — the dashboard opens with 3 pre-configured intersections
- Click "▶ Start" to begin the traffic simulation
- Watch vehicles arrive, queue up, and flow through green signals
- Switch intersections using the dropdown to monitor different junctions
- Trigger emergencies with the "⚠ Emergency" button to test priority override
- Export data using "📄 Export CSV" to save all events for analysis
- Stop the simulation anytime with "■ Stop"
Edit config.py to customize the system:
CONFIG = {
"CONGESTION_THRESHOLD": 15, # Queue length for congestion alert
"MIN_GREEN_TIME": 10, # Minimum green phase (seconds)
"MAX_GREEN_TIME": 60, # Maximum green phase (seconds)
"EMERGENCY_PRIORITY_TIME": 20, # Emergency override duration
"VEHICLE_SPAWN_RATE": 0.55, # Traffic density (0.0 - 1.0)
"GUI_REFRESH_RATE": 500, # Dashboard refresh (ms)
}Python-Based-Traffic-Management-System/
├── traffic_management_system.py # Main application (530+ lines)
├── config.py # Configuration file
├── requirements.txt # Dependencies (all optional)
├── LICENSE # MIT License
├── CONTRIBUTING.md # Contribution guidelines
├── README.md # This file
├── screenshots/ # Application screenshots
│ ├── 01_main_dashboard.png
│ ├── 02_emergency_mode.png
│ ├── 03_congestion_detection.png
│ ├── 04_csv_export.png
│ └── 05_architecture.png
├── docs/
│ └── Traffic_Management_System_Guide.pdf # Detailed PDF guide
├── tests/
│ └── test_controller.py # Unit tests
└── logs/ # Exported CSV logs (gitignored)
# With pytest
cd tests
python -m pytest test_controller.py -v
# Without pytest (built-in runner)
python tests/test_controller.pyA comprehensive 15-chapter PDF guide is included in docs/:
| Chapter | Topic |
|---|---|
| 1 | Introduction & Overview |
| 2 | System Architecture & Design |
| 3 | Development Environment Setup (Windows, macOS, Linux) |
| 4 | Core Data Models & Structures |
| 5 | Adaptive Traffic Signal Controller |
| 6 | Emergency Vehicle Priority System |
| 7 | Congestion Detection & Analytics |
| 8 | GUI Dashboard (Tkinter) |
| 9 | Intersection Visualization Engine |
| 10 | Data Logging & CSV Export |
| 11 | Full Source Code Walkthrough |
| 12 | Testing & Validation |
| 13 | Deployment (all platforms) |
| 14 | Future Enhancements |
| 15 | Appendix & References |
- OpenCV Integration — Camera-based vehicle detection and counting
- Machine Learning — Reinforcement learning for signal optimization
- Web Dashboard — Flask/FastAPI + React frontend
- Green Wave — Coordinated timing across sequential intersections
- Database — SQLite/PostgreSQL for persistent logging
- REST API — Remote monitoring and control
- YOLO Detection — Real-time vehicle classification with deep learning
Contributions are welcome! See CONTRIBUTING.md for guidelines.
# Fork → Clone → Branch → Code → Test → PR
git checkout -b feature/amazing-feature
git commit -m "Add: amazing feature"
git push origin feature/amazing-featureThis project is licensed under the MIT License — see LICENSE for details.
- Liveupx.com — Project development & documentation
- xHost — Infrastructure & hosting support
- The open-source Python community
- Traffic engineering researchers worldwide
⭐ Star this repo if you find it helpful!
Made with ❤️ by Liveupx.com & xHost