Metadata-Version: 2.5
Name: agentic-google-flights-tool
Version: 0.4.3
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'
Provides-Extra: mcp
Requires-Dist: mcp<3,>=2; extra == 'mcp'
Description-Content-Type: text/markdown

# Agentic Flights

Give an AI your trip plans. It searches Google Flights across airports, dates, and
trip lengths, compares the best options, and checks current prices before you choose.

## Give this to your AI

Copy this prompt into Codex or Claude Code and replace the trip details:

```text
Install Agentic Flights with:
`python -m pip install -U agentic-google-flights-tool`

Install its reusable skill for the AI app you are using:
- Codex: `agentic-flights init-skill --scope user --harness codex`
- Claude Code: `agentic-flights init-skill --scope user --harness claude`

Use the installed Agentic Flights skill to find the best flights for my trip.
Explore flexible dates, nearby airports, and trip lengths when they
could improve the result. Show options that balance price and travel time. Check
the current total price and baggage rules for the best options. Tell me if any part
of the search was incomplete. Do not book anything.

Trip: [origin, destination, dates or flexibility, trip length, travelers,
currency, baggage, stop limits, and timing or airline preferences].
```

## Install it yourself

Agentic Flights requires Python 3.11 or newer. It uses Google Chrome if installed.
Otherwise, install Chromium:

```sh
python -m pip install -U agentic-google-flights-tool
python -m playwright install chromium
```

Install the skill in the current project for both Codex and Claude Code:

```sh
agentic-flights init-skill
```

This adds the skill to `.agents/skills` for Codex and `.claude/skills` for Claude
Code. Add `--scope user` to use it in every project. It will not replace a changed
skill unless you pass `--force`.

## What it can do

- Search one-way, round, and multi-city trips, including trips that return from a
  different city or to a different airport.
- Explore nearby airports, dates, and stay lengths; filter by price, stops, airline,
  time, duration, and overhead cabin bag.
- Compare price against travel time without mixing different currencies.
- Check the current total price, same-flight match, baggage rules, and booking links.
- Say when it could not read a flight, stopped early, or still has work to do.

## Ways agents can use it

The skill is the easiest way to start. The package also has a Python API, a
command-line interface, and an optional local MCP connection for AI apps:

```sh
python -m pip install -U "agentic-google-flights-tool[mcp]"
agentic-flights-mcp
```

Run `agentic-flights guide` for the workflow or `agentic-flights guide <operation>`
for one operation. Saved searches stay on your computer and expire after seven days
without use by default. The project does not run a hosted search service.

## Know before relying on a result

This unofficial project is not affiliated with Google. Google Flights has no
supported public search API, so page changes can break the tool. Results show what
was visible at search time; they are not reservations or price guarantees. The tool
cannot prove that Google showed every fare. Confirm the price, baggage, and seats
with the seller. The tool does not book travel.

[Agent guide](docs/agent-guide.md) · [Technical reference](docs/reference.md) ·
[PyPI](https://pypi.org/project/agentic-google-flights-tool/) ·
[Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
