✈️ fly-smart — Hidden-City Flight Deals
Find cheaper flights using hub transfer arbitrage — no API key, no browser.
Scans 70+ global hubs so Google Flights never has to.
Quick Start · How It Works · Features · Commands · Rules · Install
Choose your interface:
pip install git+https://github.com/wali-reheman/fly-smart@v1.2.0
fly-smart search LAX HKG 2026-06-15 --flexible 3git clone https://github.com/wali-reheman/fly-smart.git \
~/.hermes/skills/repos/wali-reheman/fly-smartThen just ask: "search flights from LAX to HKG on June 15"
Airlines price routes based on demand and hub competition — not just distance. This creates pricing arbitrage: flying LAX → SEA → HKG can cost less than LAX → HKG direct. fly-smart finds these combos by scanning 70+ global hubs.
✈ MULTI-ORIGIN × MULTI-DATE | LAX / SFO / OAK → HKG
Jun 15–21, 2026
─────────────────────────────────────────────────────────────
[ 1] LAX → SEA → HKG Jun 16 $588 Save $140 (19%) ★ BEST
[ 2] SFO → SEA → HKG Jun 16 $588 Save $82 (12%)
[ 3] SAN → SEA → HKG Jun 16 $598 Save $151 (20%)
[ 4] LAX → TPE → HKG Jun 17 $649 Save $85 (12%)
[ 5] OAK → TPE → HKG Jun 17 $677 Save $174 (20%)
─────────────────────────────────────────────────────────────
Real savings (May 2026):
| Route | Transfer | Savings |
|---|---|---|
| LAX → HKG | via Seattle (SEA) | $140 saved (19%) |
| IAD → HKG | via Taipei (TPE) | $103 saved (11%) |
| DCA → HKG | via San Diego (SAN) | $86 saved (8%) |
| OAK → HKG | via Taipei (TPE) | $255 saved (24%) |
| 70+ global hubs | Northeast Asia, China, SEA, Middle East, Europe, US coasts |
| Multi-date | Scan ±7 days in parallel across all hubs |
| Multi-origin | Compare LAX, SFO, SAN, SJC, OAK simultaneously |
| SQLite cache | 1-hour TTL — same routes are instant on repeat |
| Rule verification | --verify-rules checks 3h buffer and transit visa |
| CSV / Notion export | --export-csv or --export-notion |
| Price alerts | --alert-below $X for cron-style monitoring |
# Basic search
fly-smart search LAX HKG 2026-06-15
# Flexible dates — scan ±3 days
fly-smart search LAX HKG 2026-06-15 --flexible 3
# Multi-origin — compare 5 California airports
fly-smart search LAX,SFO,OAK,SAN,SJC HKG 2026-06-15 --flexible 3
# Verify self-transfer rules (3h buffer, transit visa)
fly-smart verify LAX HKG 2026-06-15
# Alert if any deal drops below $600
fly-smart alert LAX HKG 2026-06-15 --alert-below 600
# Export to CSV
fly-smart export LAX HKG 2026-06-15 --csv-output ~/deals.csv
# All 70+ hubs (default: 25)
fly-smart search LAX HKG 2026-06-15 --all-hubs
# Business class, 3 passengers
fly-smart search LAX HKG 2026-06-15 -c business -p 3
⚠️ These deals require two separate one-way tickets.
- ✅ Two separate bookings — not as a round-trip
- ✅ Carry-on only — no checked bags (they won't transfer between tickets)
- ✅ 3+ hour buffer between connecting legs
- ✅ Check transit visa requirements for the hub country
PRs welcome! See CONTRIBUTING.md for setup instructions.
MIT — see LICENSE