opensky-cli 0.1.0__py3-none-any.whl

opensky_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: opensky-cli
+Version: 0.1.0
+Summary: The first agentic flight search engine. Searches hundreds of routes in minutes, not hours.
+Project-URL: Homepage, https://github.com/federicodeponte/opensky
+Project-URL: Repository, https://github.com/federicodeponte/opensky
+Author: Federico De Ponte
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,flight-search,flights,google-flights,price-comparison,travel
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet
+Requires-Python: >=3.11
+Requires-Dist: airportsdata>=20240101
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: diskcache>=5.6
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.10
+Requires-Dist: ratelimit>=2.2
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.15
+Description-Content-Type: text/markdown
+
+# opensky
+
+The first agentic flight search engine. Define your origins, destinations, and dates, and opensky searches every combination for you, in minutes instead of hours.
+
+```
+$ opensky scan --config scan.toml
+
+Scanning 6 origins x 6 destinations x 10 dates = 360 combos via google
+
+Best per Destination
+Destination   Price   Date         Duration   Route
+Amsterdam     €289    Tue Mar 17   11h 20m    Bangkok → Amsterdam
+Berlin        €312    Thu Mar 12   12h 45m    Kuala Lumpur → Berlin
+Frankfurt     €298    Wed Mar 11   11h 50m    Bangkok → Frankfurt
+Hamburg       €357    Tue Mar 10   13h 10m    Bangalore → Dubai → Hamburg
+Munich        €315    Fri Mar 13   12h 30m    Delhi → Munich
+Copenhagen    €345    Mon Mar 16   13h 10m    Singapore → Copenhagen
+```
+
+Doing this manually on Google Flights would take 360 individual searches. opensky does it in one command.
+
+## How it works
+
+1. You define a search space: origins, destinations, date range
+2. opensky searches every combination across up to three providers (Google Flights, Duffel, Amadeus)
+3. Results are deduplicated, scored, and presented as a price matrix with the cheapest options highlighted
+
+It also works for single route searches:
+
+```bash
+opensky search bangalore hamburg tomorrow
+opensky search BLR HAM next monday
+opensky search BLR HAM mar 15
+```
+
+## Install
+
+Requires Python 3.11+.
+
+```bash
+pip install opensky
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/federicodeponte/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 (optional, Google Flights works without any keys).
+
+## Quick demo
+
+See what opensky does without any API keys or network calls:
+
+```bash
+opensky demo
+```
+
+![opensky demo](demo.gif)
+
+## Usage
+
+### Multi-route scan (the power feature)
+
+Search every combination of origins, destinations, and dates at once.
+
+#### Interactive setup
+
+```bash
+opensky config init
+```
+
+```
+opensky config init
+
+Where are you flying from? (comma-separated cities or codes): bangalore, delhi, bangkok
+  → BLR (Bangalore), DEL (Delhi), BKK (Bangkok)
+Where to? (comma-separated cities or codes): hamburg, frankfurt, amsterdam
+  → HAM (Hamburg), FRA (Frankfurt), AMS (Amsterdam)
+Start date (YYYY-MM-DD): mar 15
+End date (YYYY-MM-DD): mar 25
+Currency [EUR]:
+
+Created scan.toml. Next: opensky scan --config scan.toml
+```
+
+Then run:
+
+```bash
+opensky scan --config scan.toml
+```
+
+#### Quick template
+
+```bash
+opensky config init --quick    # dumps template, no prompts
+# edit scan.toml with your routes and dates
+opensky scan --config scan.toml
+```
+
+6 origins x 6 destinations x 10 dates = 360 searches, one command. You get:
+- **Best per destination**: cheapest flight to each city, with date and route
+- **Price matrix**: prices across all dates, cheapest highlighted
+- **Stats**: total flights found, price range
+
+```bash
+opensky scan --config scan.toml --all-flights    # show every flight, not just summary
+opensky scan --config scan.toml --workers 5      # parallel workers (default: 3)
+opensky scan --config scan.toml --json -o results.json
+```
+
+Scans are cached. If interrupted, re-run the same command to resume where it left off.
+
+#### Scan config
+
+```toml
+[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-03-10"
+end = "2026-03-20"
+
+[scoring]
+price_weight = 1.0
+duration_weight = 0.5
+
+# Optional: add ground transit time for scoring
+[connections]
+final_destination = "Hamburg"
+
+[connections.transit_hours]
+HAM = 0
+BER = 2
+FRA = 4
+
+[safety]
+risk_threshold = "high_risk"
+```
+
+### Single route search
+
+Use city names, IATA codes, or friendly dates:
+
+```bash
+opensky search bangalore hamburg tomorrow
+opensky search BLR HAM next monday
+opensky search BLR HAM mar 15 --class business
+opensky search BLR HAM 2026-03-10 --source duffel
+opensky search BLR HAM 2026-03-10 --json
+opensky search BLR HAM 2026-03-10 --fresh
+```
+
+Options:
+- `--class` / `--cabin`: Travel class (economy, premium, business, first)
+- `--stops`: Max stops (nonstop, 1, 2, or any)
+- `--max-price`: Maximum price (0 = no limit)
+- `--fresh` / `--no-cache`: Skip cached results
+- `--source` / `--provider`: Flight data source (google, duffel, amadeus)
+- `--include-risky`: Include flights through conflict zones
+- `--json` / `--csv`: Machine-readable output
+- `--output` / `-o`: Save results to file
+- `--currency` / `-c`: Currency code (EUR, USD, GBP, etc.)
+
+## Providers
+
+opensky aggregates results from up to three flight data sources. When multiple providers are configured, results are deduplicated (same flight from two sources keeps the cheapest price).
+
+| Provider | Env vars | Notes |
+|----------|----------|-------|
+| Google Flights | none (default) | Scrapes Google Flights. Needs residential IP. |
+| [Duffel](https://duffel.com) | `OPENSKY_DUFFEL_TOKEN` | Free unlimited searches. |
+| [Amadeus](https://developers.amadeus.com) | `OPENSKY_AMADEUS_KEY` + `OPENSKY_AMADEUS_SECRET` | Free tier: 2,000 calls/month. |
+
+## Conflict zones
+
+opensky ships with a conflict zone database. By default, flights through high-risk airspace are filtered out. Use `--include-risky` to see all options.
+
+```bash
+opensky zones              # list active conflict zones
+opensky zones --update     # fetch latest data
+```
+
+## Limitations
+
+- **Residential IP required**: Google Flights blocks datacenter IPs. Use `--proxy` on servers. Duffel and Amadeus work from any IP.
+- **Rate limits**: All providers rate-limited to 10 req/sec. Default scan settings (3 workers, 1s delay) are conservative.
+- **Price accuracy**: Prices may differ from airline websites. Always verify before booking.
+
+## Credits
+
+Flight data API based on [fli](https://github.com/punitarani/fli) by Punit Arani (MIT license). Airport metadata from [airportsdata](https://github.com/mborsetti/airportsdata).
+
+## License
+
+MIT

opensky_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+opensky/__init__.py,sha256=0HDEdjIp7kcUzKERDzmwxelUgXPtz3vmmJglmChyFlo,93
+opensky/__main__.py,sha256=3Z9SSjLTwDx1WdJQ5D5AZv9Yd2NtnVdORrFp6c1IWHY,35
+opensky/airports.py,sha256=FdJ0z2MEx3CqW3lfqM2u695KZMVK3WY4syb89ClvxhM,6087
+opensky/cache.py,sha256=sxPe0xDhOXSist5_LOfBbkpTYdnh8652ls1xVAZ-rmA,1077
+opensky/cli.py,sha256=JEP797hCWznjGSgXtOainRnLScYkJPns3EUxM3riVZY,25993
+opensky/config.py,sha256=yvy-u4I0DCntU49UFDJ1HeYDw15OnghKe8IvjeUc6Js,4250
+opensky/display.py,sha256=ysi5ALyUSTEJJS9B4Fzg6lU6yZxu3BbYatRBoiBBt_I,11307
+opensky/models.py,sha256=jsBvwk2dKVsqXPp3A5iH01UqvBkPIfU_TZwRMeVF6hY,1915
+opensky/safety.py,sha256=85k4T_LpM9RSVXDPMfIOFTtoa9GifmGUlq9zkWTTiOg,4344
+opensky/search.py,sha256=JtWLzVTm8AbAyWGyGDAAEmkrBP7FfTnW4FzlMZJjoSA,9318
+opensky/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+opensky/_vendor/google_flights.py,sha256=ArlVcvgsyzNMIYGdXvXYJpVB603i3qpr8Fo1z1EZfBY,15792
+opensky/data/conflict_zones.json,sha256=wsPLehFktFtdqEGzURrudaxVgm-y1nfVdRfwFE6RNHE,5839
+opensky/data/demo_flights.json,sha256=J3TvIg61CY6s6XZYFNXD85TCSIXJ3aoy1gaOyDGh-xg,55647
+opensky/providers/__init__.py,sha256=doqKF2Lk8kEXBQ9fceQmsjvrgHL1jYL6bgi8dDd20-I,2389
+opensky/providers/amadeus.py,sha256=2S70ZYscWpn4D16AMahVnQJwE2vHoNAlmhJAR2qZ19M,4456
+opensky/providers/duffel.py,sha256=xSR7NWeSYg106JG31fdOCL9jXerLmkhZCeXYKwn2buQ,3655
+opensky/providers/google.py,sha256=ym-Y88mCN1FO7b4CXRzJk87XubQVDqDjX8Rpmd3z7w8,2967
+opensky_cli-0.1.0.dist-info/METADATA,sha256=PeWBbT5trwwob-LV5zYp67F-nLcz8eSK8IPbsvZi9_o,7031
+opensky_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+opensky_cli-0.1.0.dist-info/entry_points.txt,sha256=D2fUfXLUPGHLDbvU9la_L2sM1K_T0LtFrKtmokqmRQI,44
+opensky_cli-0.1.0.dist-info/licenses/LICENSE,sha256=Md2RK71FyXmJe4RxcTPGqVWirayGh-6lT5rCgtzbXFo,1074
+opensky_cli-0.1.0.dist-info/RECORD,,

opensky_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

opensky_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opensky = opensky.cli:app

opensky_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Federico De Ponte
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.