Flight and hotel search for your terminal, Python, and AI assistants. Runs on your machine, no API keys.
Website · Usage guide · Architecture · Changelog
It reads Google Flights, Google Hotels, and Booking.com directly, and Skiplagged when you opt in. It returns prices, itinerary details, and links. It reports what the provider returned and says so when something is unknown; it never invents a fare.
Quick start
Requires Python 3.10+.
pip install viajante
viajante flights JFK-LHR:2026-11-15 --fetch sweep
viajante hotels London 2026-11-15 2026-11-20 --currency GBP --source google
Use future dates. Not sure of a code? viajante airports london.
Prefer not to install? uvx --from viajante viajante airports JFK, or
npx -y -p @viajante/mcp viajante airports JFK (both need uv).
These searches use plain HTTP. Booking.com and --fetch detail need the
browser extra.
Connect an AI assistant
Add this to your assistant's MCP configuration (needs
uv and Python 3.10+):
{
"mcpServers": {
"viajante": {
"command": "npx",
"args": ["-y", "@viajante/mcp"]
}
}
}
Without Node, use "command": "uvx" with
"args": ["--from", "viajante[mcp]", "viajante-mcp"]. That covers Google
Flights and Hotels with no Chromium. The npm entry also includes the browser
extra, which search_explore needs.
Then ask in plain language:
Find a seven-night round trip from BOS to LHR, departing any day in November 2026. Compare the dates.
Hotels in Tokyo, November 12 to 16, two adults, free cancellation, in JPY.
Every tool result (except lookup_airports) carries one envelope: status,
completeness, empty_reason, retry_after, observed_at. Only
empty_reason: provider_empty means the provider found nothing. A client that
only takes a URL can use viajante-mcp --transport streamable-http; it has no
auth, so keep it on loopback (details).
Command line
Run viajante <command> --help for options. Add --save FILE to write a JSON report.
viajante dates BOS-LHR --from 2026-11-01 --to 2026-11-30 --nights 7
Python
from viajante import get_flights
report = get_flights("JFK-LHR:2026-11-15", fetch="sweep", top=5)
for result in report.queries:
if result.status == "ok":
for offer in result.offers:
print(offer.price, report.currency, offer.airline, offer.duration)
else:
print(result.error)
FlightQuery, HotelQuery, and the search_* functions are exported too;
see the Python examples.
Optional browser support
pip install 'viajante[browser]'
playwright install chromium
For uvx, use viajante[mcp,browser] in --from and install Chromium from
that same environment.
Good to know
- Currency. Taken from
--currency, or from a named origin airport's country. Hotels always need one. Viajante never converts between currencies. - Baggage.
--carry-onasks Google to price one carry-on. Checked bags (--bags) are refused, because no transport can verify them.--baggage-bufferonly affects ranking; it is not a quoted fee. - Hotels. Prices are for the whole stay. Free cancellation is required unless you opt out. Google rates 0–5, Booking.com 0–10.
- Recommendation. Flight results may include a short
recommendationblock. It adds to the offer list and never replaces it. - Price level. Flight results may include Google's own price level
(
low,typical, orhigh) from the results page already fetched. It is Google's label for that price against its typical range.--price-historyadds the page's price history. No extra request. - Unknown stays unknown. Missing fields are left out or marked unknown.
Travel sites change their pages, block requests, and update prices at any time. Confirm the final fare, baggage, hotel total, and cancellation terms with the provider before you book.
Contributing
Bug reports and focused pull requests are welcome; see CONTRIBUTING.md.
License
MIT. Independent project, not affiliated with Google, Booking.com, or any airline. Use of those services is subject to their terms: Google, Booking.com.
