Metadata-Version: 2.5
Name: agentic-google-flights-tool
Version: 0.1.0
Summary: Explore and compare flight options with AI agents
Project-URL: Homepage, https://github.com/alberto-tamez/agentic-google-flights-tool
Project-URL: Repository, https://github.com/alberto-tamez/agentic-google-flights-tool
Project-URL: Issues, https://github.com/alberto-tamez/agentic-google-flights-tool/issues
Author: Alberto Tamez Gonzalez
License-Expression: MIT
License-File: LICENSE
Keywords: browser-automation,flights,google-flights,travel
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Requires-Python: >=3.11
Requires-Dist: fast-flights==3.1.0
Requires-Dist: playwright<2,>=1.62
Requires-Dist: pydantic<3,>=2.10
Provides-Extra: dev
Requires-Dist: pytest<9,>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: fli
Requires-Dist: flights==0.9.0; extra == 'fli'
Description-Content-Type: text/markdown

# Agentic Flights

Find the best flights for your trip with your AI. Compare flexible dates, nearby airports, and trip lengths, then get a shortlist of the options worth booking.

## Give this to your AI

Copy this into an AI agent with terminal access and add your trip details:

```text
Install and use Agentic Flights from
https://github.com/alberto-tamez/agentic-google-flights-tool.
Follow its README and the bundled agent guide to find the best flights for my trip.

My trip: [departure city, destination, dates or flexibility, travelers,
and preferences].
```

For example: “Madrid or Barcelona to Japan for about two weeks in October 2027. One adult, an overhead cabin bag, and at most one stop. I'd like a good balance of price and travel time.”

## Install

Requires Python 3.11 or newer. Install the Python package from GitHub:

```sh
python -m pip install "git+https://github.com/alberto-tamez/agentic-google-flights-tool.git"
```

Then read the included instructions:

```sh
agentic-flights guide
```

The tool uses Google Chrome if installed. Otherwise:

```sh
python -m playwright install chromium
```

## For agents

Start with `agentic-flights guide`. Load `agentic-flights guide reference` or
`agentic-flights guide schema` only when needed. Explore and compare results in
code, keep full reports outside the conversation, and verify the strongest
options before recommending them.

The package includes a Python API and CLI. An MCP server is not included yet.
Search coverage is limited by what Google returns, and fares can change.
This unofficial project is not affiliated with Google.

[Agent guide](docs/agent-guide.md) · [Technical reference](docs/reference.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
