opensky is an open-source flight search CLI that aggregates Google Flights, Duffel, and Amadeus results, then flags itineraries that transit through risky airports, land in risky countries, or appear to overfly whole-country conflict zones on regional segments.
- one-way itineraries returned by the configured providers
- airports and countries present in the itinerary
- regional great-circle overflight screening for whole-country conflict zones
- airport-based advisories for partial-region conflict zones
- risk levels from the bundled or refreshed conflict-zone dataset
- price and duration scoring across single-route searches and multi-route scans
It does not ingest filed routings, live FIR closures, or airline-specific detours. Partial-region and FIR-style advisories without bundled geometry remain airport-based.
Requires Python 3.11+.
Install from PyPI:
pip install opensky-cliGitHub install still works:
pip install "git+https://github.com/buildingopen/opensky.git"Or from source:
git clone https://github.com/buildingopen/opensky.git
cd opensky
python -m venv .venv && source .venv/bin/activate
pip install -e .Copy .env.example to .env and fill in any API keys you have. Google Flights works without any keys.
skyroute remains available as a compatibility command for now, but opensky is the canonical CLI.
See the full output without any API keys or network calls:
opensky demo
opensky demo --show-risky
opensky supports three providers. Google Flights is always available. Duffel and Amadeus activate automatically when their env vars are set.
| Provider | Env vars | Notes |
|---|---|---|
| Google Flights | none (default) | Scrapes Google Flights. Needs a residential IP. |
| Duffel | OPENSKY_DUFFEL_TOKEN |
Fallback: SKYROUTE_DUFFEL_TOKEN. |
| Amadeus | OPENSKY_AMADEUS_KEY + OPENSKY_AMADEUS_SECRET |
Fallback: legacy SKYROUTE_AMADEUS_KEY + SKYROUTE_AMADEUS_SECRET. |
When multiple providers are configured, results are aggregated and deduplicated. If one provider fails, the CLI reports partial results. If every provider fails, the command exits non-zero.
Use --provider / -p to limit to a single provider:
opensky search BLR HAM 2026-04-10 --provider duffelopensky search BLR HAM 2026-04-10
opensky search BLR HAM 2026-04-10 --currency EUR --show-risky
opensky search BLR HAM 2026-04-10 --json
opensky search BLR HAM 2026-04-10 --provider duffelGenerate a config file:
opensky config initEdit scan.toml with your origins, destinations, and dates, then:
opensky scan --config scan.toml
opensky scan --config scan.toml --workers 5 --json -o results.jsonScans are cached. If interrupted, rerun the same command to reuse cached provider results.
opensky zones
opensky zones --updateopensky cache stats
opensky cache clear[search]
origins = ["BLR", "DEL", "BOM", "KUL", "BKK", "SIN"]
destinations = ["HAM", "FRA", "MUC", "BER", "AMS", "CPH"]
cabin = "economy"
currency = "EUR"
stops = "any"
[search.date_range]
start = "2026-04-10"
end = "2026-04-20"
[safety]
# Hide routes at or above this level.
# Options: do_not_fly | high_risk | caution
risk_threshold = "high_risk"
[scoring]
price_weight = 1.0
duration_weight = 0.5
[connections.transit_hours]
HAM = 0
HAJ = 1.5
BER = 2
FRA = 4
MUC = 5.5
AMS = 5
CPH = 5opensky ships with a bundled conflict-zone database based on:
- EASA Conflict Zone Information Bulletins (CZIB)
- Safe Airspace
- FAA NOTAMs
- Natural Earth 50m admin 0 country geometry
The dataset maps countries and specific airports to SAFE, CAUTION, HIGH_RISK, and DO_NOT_FLY. Whole-country zones also use bundled country geometry for regional overflight screening.
Run opensky zones --update to fetch the latest dataset from GitHub.
This is informational only. Always check official NOTAMs and airline advisories before booking.
- Google Flights often requires a residential IP. Use
--proxyif you are running searches from a server. - Prices can differ from airline and OTA checkout pages.
- The conflict-zone database is a best-effort dataset and can be incomplete or stale.
- Overflight screening uses a regional great-circle proxy, not filed flight plans or live ATC reroutes.
- FIR-level closures without bundled geometry still require airport-based or manual review.
CI runs on Python 3.11 through 3.14. Tagging v* triggers the release workflow, which builds distributions, creates a GitHub release, and can optionally publish to PyPI if trusted publishing is configured.
See RELEASING.md for the release steps.
Flight data API based on fli by Punit Arani (MIT license).
Airport metadata from airportsdata.
MIT