omarishevo/kenya-port

# 🚢 KPA Vehicle Traffic & Congestion Analytics Dashboard > **Kenya Ports Authority — Policy and Research Section** > Research Report on Vehicle Traffic and Congestion at KPA Gates · June 2025 --- ## 📌 Overview This is an interactive **Streamlit analytics dashboard** built on top of the Kenya Ports Authority (KPA) research survey conducted in May–June 2025. The study investigated vehicle traffic congestion at KPA access gates — Port of Mombasa and ICD Nairobi — and collected responses from **879 respondents** across five stakeholder groups. The dashboard provides: - **Exploratory data analysis** of all five survey datasets - **Machine learning models** to predict congestion risk and gate wait time - **Interactive prediction tool** for individual driver profiling - **Recommendation matrix** from the official KPA research report --- ## 📁 Project Structure ``` 📦 kenya-port/ ├── port.py # Main Streamlit application ├── requirements.txt # Python dependencies ├── README.md # This file └── COMBINED_DATASETS.csv # Combined survey data (upload in app) ``` ### Original Source Datasets (upload in app) | File | Respondents | Description | |------|------------|-------------| | `TRUCK_EXCEL_DATASET.xlsx` | 714 | Truck drivers — gate usage, wait times, congestion causes | | `CLEARING_AGENTS_EXCEL_ANALYSIS.xlsx` | ~124 | Clearing agents — documentation, gate usage | | `KPA_STAFF_EXCEL_DATASET.xlsx` | 22 | KPA staff — operations, staffing, infrastructure | | `CUSTOM_EXCEL_DATASET.xlsx` | 10 | Customs/KRA officials — scanning, documentation | | `TRAFFIC_POLICE_EXCEL_DATASET.xlsx` | 9 | Traffic police — congestion causes, solutions | --- ## 🚀 Getting Started ### 1. Clone or Download the Project ```bash git clone github.com cd kenya-port ``` ### 2. Install Dependencies ```bash pip install -r requirements.txt ``` ### 3. Run the App ```bash streamlit run port.py ``` ### 4. Upload Your Data O …