LeroyJoel/naija-route-optimizer

# 🚗 Naija Route Optimizer **AI-Powered Route Optimization for Nigerian Cities** A CrewAI-powered multi-agent system that optimizes travel routes across Nigerian cities, providing cost-effective transportation solutions with real-time traffic considerations. ## 🎯 What It Does The Naija Route Optimizer analyzes your travel needs and provides: - **Smart Route Planning**: Optimized routes considering traffic, time, and cost - **Transport Options**: Local transport recommendations (Danfo, Keke, Okada, BRT, ride-hailing) - **Cost Analysis**: Budget-friendly transportation solutions - **Logistics Optimization**: SME delivery and freight planning - **Real-time Insights**: Traffic-aware recommendations ## 🏗️ Architecture Built with **CrewAI**, featuring 5 specialized AI agents: 1. **Transport Intake Agent** - Parses travel requirements 2. **Route Designer** - Plans optimal routes using Nigerian road networks 3. **Transport Guide** - Recommends local transport options 4. **Logistics Optimizer** - Optimizes delivery and freight solutions 5. **Report Aggregator** - Generates comprehensive travel reports ## 🚀 Quick Start ### Prerequisites - Python 3.10-3.13 - Gemini API key - Serper API key ### Installation 1. **Clone the repository** ```bash git clone github.com cd naija_route_optimizer ``` 2. **Install dependencies** ```bash pip install uv uv sync ``` 3. **Set your Gemini/Serper API keys** ```bash # Windows PowerShell $env:GEMINI_API_KEY="your_gemini_api_key_here" $env:SERPER_API_KEY="your_gemini_api_key_here" # Linux/Mac export GEMINI_API_KEY="your_gemini_api_key_here" ``` 4. **Run the optimizer** ```bash crewai run ``` ## 📱 Streamlit App For interactive demos and presentations: ```bash streamlit run streamlit_app.py ``` ## 🎭 Demo Example **Input**: "I need to travel from Ikeja to Ajah at 7AM tomorrow for work. I don't want to spend too much on transport." **Output**: - **Route**: Ikeja → Oshodi (Bus) → Ajah (Okada) …