About
Weekend Planner is a smart trip planning tool that generates 1-3 weekend options optimized for total landed cost with transparent breakdown of base prices, fees, VAT, promotions, and foreign exchange rates.
Optional dining suggestions near your destination help complete your weekend experience.
Key Features
💰 Budget-First
Optimizes trip options based on your total budget with complete cost transparency.
🎫 Multi-Vendor
Integrates with multiple ticket vendors to find the best deals.
🍽️ Dining Integration
Optionally bundles nearby dining suggestions with your weekend plans.
💱 FX Aware
Handles foreign exchange rates for accurate international pricing.
Quick Start
Install and run Weekend Planner with these simple commands:
pip install -e .
pytest -q
python app/main.py --date 2025-11-02 --budget-pp 30 --with-dining
# Or run as a web app:
uvicorn app.server:app --host 0.0.0.0 --port 8000Technology Stack
- Python 3.10+ - Core language
- FastAPI - Web framework for API endpoints
- Pydantic - Data validation
- LightGBM - Machine learning for price predictions
- Pandas & NumPy - Data processing
- HTTPX - Async HTTP client
🚀 Try It Now!
Experience the Weekend Planner running live in your browser - no setup required!
Launch Live App ➡️