Agent-native flight search & booking. Saved $116 across 5 routes vs Google Flights (verified). 400+ airlines in 5 seconds. Join the community - Star and spread the word
Finding a flight shouldn't mean checking 47 websites. Or 3 hours of searching.
Or having that feeling you could've got a better deal if you'd just waited a little longer.
So we built something about it.
No markup. No tracking. No price that goes up because you looked twice.
Join the community. Help others find cheaper flights. Spread the word.⭐ Star the repo. Share with a friend ✈️
Your AI agent just learned to book flights.
400+ airlines. Real prices. One function call.
LetsFG gives your AI agent flight search and booking superpowers. 200+ connectors fire in parallel on your machine, scanning the entire world for the cheapest price. Zero markup. Real airline tickets.
The same flight costs $20–$50 less because you skip OTA inflation, cookie tracking, and surge pricing.
Prerequisite: GitHub star verified via link_github first
HTTP 403: GitHub star not verified — call link_github first
HTTP 410: Offer expired — airline sold the seats, search again (OfferExpiredError)
Note: confirmed_price may differ from search price (airline prices change in real-time). After unlock, you have 30 minutes to call book. If the window expires, search again (free) and unlock again (free).
CRITICAL: Use real passenger names (must match passport/ID) and real email (airline sends e-ticket there)
Payment flow: Your Stripe card is charged the ticket price → LetsFG books via the airline → you get the PNR. If the airline booking fails, you are automatically refunded.
hotel_checkrate
Confirm hotel rate before booking (required if rate_type=RECHECK).
Input: holder_name, holder_surname, rooms with rate_key and paxes
Output: reference, status, hotel details, total_net
hotel_voucher
Get guest voucher for hotel check-in.
Cost: FREE
Input: booking reference
Output: Hotel name, dates, room type, board, payment notice
hotel_cancel
Cancel a hotel booking or simulate cancellation.
Cost: Depends on cancellation policy
Input: reference, simulate (true/false)
Output: cancellation_amount, currency, status
register
Register a new AI agent.
Cost: FREE
Input: agent_name, email
Output: api_key (permanent credential)
setup_payment
Attach a payment card for booking. Required before booking flights.
Cost: FREE (attaching the card is free; you are charged the ticket price when you book)
Input: token (e.g. "tok_visa" for testing) or payment_method_id or card details
Output: Payment status confirmation
Note: Must be called once before your first booking. The card stays on file for future bookings.
get_agent_profile
Get current agent's profile, usage stats, and payment status.
Cost: FREE
Output: Agent details, search count, booking count, payment status
Authentication
All endpoints except register require an X-API-Key header.
X-API-Key: trav_...
Get your key by calling POST /api/v1/agents/register with agent_name and email. The key is permanent — save it once.
After registration, star the GitHub repo and link your account via POST /api/v1/agents/link-github to unlock and book for free.
Complete Workflow
Flight Booking (6 API calls)
1. POST /api/v1/agents/register → Get API key (once)
2. POST /api/v1/agents/link-github → Star repo + verify (once)
3. POST /api/v1/agents/setup-payment → Attach payment card (once)
4. POST /api/v1/flights/search → Search flights (FREE)
5. POST /api/v1/bookings/unlock → Unlock offer (FREE)
6. POST /api/v1/bookings/book → Book flight (ticket price charged via Stripe)
Hotel Booking (6 API calls)
1. POST /api/v1/agents/register → Get API key (once)
2. POST /api/v1/agents/link-github → Star repo + verify (once)
3. POST /api/v1/hotels/search → Search hotels (FREE)
4. POST /api/v1/hotels/checkrate → Confirm price (if rate_type=RECHECK)
5. POST /api/v1/hotels/book → Book room
6. GET /api/v1/hotels/voucher/{ref} → Get guest voucher
| Code | Class | Description | Typical Use Case |
|------|-------|-------------|------------------|
| M | Economy | Standard seating | Budget travel, most bookings |
| W | Premium Economy | Extra legroom, priority boarding | Long-haul comfort without business price |
| C | Business | Lie-flat on long-haul, lounge access | Corporate travel, 6+ hour flights |
| F | First | Private suites, premium dining | Ultra-premium routes (limited airlines) |
| --json | — | Output as JSON | — |
Error Handling
| Exception | HTTP Code | When |
|-----------|-----------|------|
| AuthenticationError | 401 | Invalid or missing API key |
| PaymentRequiredError | 402 | No payment method (legacy flow) |
| OfferExpiredError | 410 | Offer no longer available |
| LetsFGError | 422 | Invalid request parameters |
| LetsFGError | 429 | Too many requests (retry with backoff) |
| LetsFGError | 502 | Upstream airline/hotel API error |
Authentication Failure Recovery
from letsfg import LetsFG, AuthenticationError
try:
bt = LetsFG(api_key="trav_...")
flights = bt.search("LHR", "JFK", "2026-04-15")
except AuthenticationError:
# API key invalid or expired — re-register
creds = LetsFG.register("my-agent", "agent@example.com")
bt = LetsFG(api_key=creds["api_key"])
# Don't forget to link GitHub
bt.link_github("your-github-username")
Rate Limit and Timeout Handling
import time
from letsfg import LetsFG, LetsFGError
def search_with_retry(bt, origin, dest, date, max_retries=3):
for attempt in range(max_retries):
try:
return bt.search(origin, dest, date)
except LetsFGError as e:
if "429" in str(e) or "rate limit" in str(e).lower():
time.sleep(2 ** attempt) # exponential backoff
elif "timeout" in str(e).lower() or "504" in str(e):
time.sleep(1)
else:
raise
raise LetsFGError("Max retries exceeded")
180+ airlines via local connectors (Playwright + httpx)
Hotels and activities via direct APIs
Zero price bias — no demand inflation, no cookie tracking
$20–50 cheaper than OTAs on average
Real airline PNR codes and hotel confirmations
E-tickets sent directly to passenger email
Search is always free and unlimited
Only requirement: star our GitHub repo for unlimited access
API designed for machines, not browsers
Supporters
Real prices: LetsFG vs Google Flights
We searched 5 routes on Google Flights and LetsFG on the same day (June 15, 2026). Same airline, same itinerary — LetsFG was cheaper every time:
| Route | Airline | Google Flights | LetsFG | You Save |
|-------|---------|---------------|--------|----------|
| LAX → Paris (CDG) | WestJet, 1 stop | $723 | $687 | $36 |
| Warsaw → Bali (DPS) | Etihad, 1 stop | $876 | $842 | $34 |
| SFO → London (LHR) | WestJet, 1 stop | $669 | $636 | $33 |
| Chicago → Miami | Spirit, nonstop | $120 | $114 | $6 |
| London → Barcelona | Vueling, nonstop | $62 | $56 | $6 |
| LA → New York (JFK) | Frontier, 1 stop | $125 | $124 | $1 |
$116 saved across 6 flights. Google Flights inflates further on repeat searches. LetsFG returns the raw airline price every time.
Why the difference? Google Flights only searches its own limited set of airline partners. LetsFG searches everywhere — 200+ connectors including Skyscanner, Kiwi, Kayak, Momondo, plus direct airline websites (Ryanair, United, Southwest, EasyJet, Spirit, Norwegian, AirAsia, and 190+ more). More sources = better prices. And unlike travel websites, LetsFG returns the raw price with zero markup, no tracking, no inflation.
Try it right now — no install needed
Don't want to install anything? Use letsfg.co and search flights instantly in your browser:
Search any route, compare live results, and unlock the booking links for the flights you want without installing anything.
When you're ready to integrate it into your own agent, keep reading.
Pricing
| How you use it | Search | Unlock | Book | Runs where? |
|----------------|--------|--------|------|-------------|
| CLI / Python SDK / npm | ✅ Free | ✅ Free | Ticket price only | Your machine |
| MCP Server (local) | ✅ Free | ✅ Free | Ticket price only | Your machine |
| letsfg.co | ✅ Free | Small one-time fee per search | Ticket price only | Our servers |
Local = 100% free. The CLI, Python SDK, npm packages, and local MCP server run 200+ connectors covering 400+ airlines on your machine. No API key needed, no fees, no limits.
letsfg.co = free search + small unlock fee. Search is free, and when you unlock a search you get the booking links for all flights from that search. Booking stays at the raw airline price — zero markup.
💡 Know someone who travels? The more people discover LetsFG, the more airlines we cover — and the better it gets for everyone. ⭐ Star · Share with a friend
Why developers star this repo
| | Google Flights / Expedia | LetsFG |
|---|---|---|
| Price | Inflated (tracking, cookies, surge) | Raw airline price. $116 cheaper across 6 verified routes. |
| Coverage | Misses budget airlines | 200+ connectors, 400+ airlines |
| Speed | 30s+ (loading, ads, redirects) | ~10 seconds |
| Repeat search raises price? | Yes | Never |
| Works in AI agents? | No | Native (CLI, MCP, SDK) |
| Booking | Redirects to OTA checkout | Real airline PNR, e-ticket to inbox |
| Cabin class filter | No | Economy, premium, business, first |
| Cost to you | Hidden markup | CLI/local: 100% free. Server: free search, 1% unlock. |
Get started in 30 seconds
pip install letsfg
Search flights immediately — no API key, no registration, no account needed:
letsfg search LHR BCN 2026-06-15
That single command fires 200+ connectors on your machine and returns real-time prices from 400+ airlines. Free. Unlimited. Zero setup.
Short on time? Use --mode fast to search only OTAs + key airlines (~25 connectors, 20-40s instead of 6+ min):
letsfg search LHR BCN 2026-06-15 --mode fast
Flying business or first? Filter by cabin class — only get results that match:
letsfg search LHR JFK 2026-06-15 --cabin C # business class
letsfg search LHR JFK 2026-06-15 --cabin F # first class
letsfg search LHR JFK 2026-06-15 --cabin W # premium economy
Want to unlock and book? Star the repo for free access:
# Star the repo on GitHub, then verify
letsfg star --github your-username
The CLI auto-registers behind the scenes and saves your API key to ~/.letsfg/config.json. No manual steps.
# Search (free, unlimited)
letsfg search LON BCN 2026-04-01 --return 2026-04-08 --sort price
# Unlock (confirms live price, holds for 30 min — free)
letsfg unlock off_xxx
# Book (ticket price only, zero markup)
letsfg book off_xxx \
--passenger '{"id":"pas_0","given_name":"John","family_name":"Doe","born_on":"1990-01-15","gender":"m","title":"mr
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
