flights

# Flight Search Search real-time flight schedules and prices via Google Flights data. ## Prerequisites ```bash pip install fast-flights ``` The `flights-search` CLI is installed at `~/.local/bin/flights-search`. ## CLI Usage ```bash flights-search <origin> <destination> <date> [options] ``` ### Examples ```bash # Basic search (auto-shows fewest stops available) flights-search YYZ EWR 2026-02-06 # Nonstop flights only flights-search YYZ JFK 2026-02-06 --nonstop # Filter by departure time (24h format) flights-search YYZ EWR 2026-02-06 --after 18 # After 6pm flights-search YYZ EWR 2026-02-06 --before 12 # Before noon flights-search YYZ EWR 2026-02-06 --after 9 --before 14 # Cabin class flights-search YYZ EWR 2026-02-06 --class economy # default flights-search YYZ EWR 2026-02-06 --class premium # premium economy flights-search YYZ EWR 2026-02-06 --class business flights-search YYZ EWR 2026-02-06 --class first # Get Google Flights booking link flights-search YYZ EWR 2026-02-06 --class business --link # Multiple passengers flights-search YYZ EWR 2026-02-06 --passengers 2 # Show all flights (ignore stop minimization) flights-search YYZ EWR 2026-02-06 --all-stops ``` ### Options | Option | Description | |--------|-------------| | `--nonstop` | Force nonstop only | | `--all-stops` | Show all flights regardless of stops | | `--after HH` | Depart after hour (24h format) | | `--before HH` | Depart before hour (24h format) | | `--class` | Cabin: economy, premium, business, first | | `--passengers N` | Number of travelers | | `--link` | Print Google Flights URL | ## Default Behavior By default, the CLI shows only flights with the **minimum stops available**: - If nonstops exist → shows only nonstops - If no nonstops → shows only 1-stop flights - Use `--all-stops` to see everything ## Output ``` Depart Arrive Airline Price Duration ---------------------------------------------------------------------------------------------------- 6:00 PM Fri, Feb 6 7:38 PM Fri, Feb 6 Air Canada $361 1 hr 38 min 9:10 PM Fri, Feb 6 10:48 PM Fri, Feb 6 Air Canada $361 1 hr 38 min 2 nonstop flight(s) found. ``` ## Data Source Uses Google Flights data via the `fast-flights` library (reverse-engineered protobuf API). No API key required. ## Notes - Date format: `YYYY-MM-DD` - Airport codes: Standard IATA codes (JFK, LAX, YYZ, etc.) - Prices are in USD - Times shown in local airport timezone