The open-source flight dispatcher for Infinite Flight pilots.
Tell it the flight you want to fly, like "Dulles to Denver tomorrow evening in the A321neo". It finds a real airline flight, generates your SimBrief plan once you approve, and hands back a briefing that starts with where to spawn and the takeoff N1 to set. It runs on your own keys and your own ChatGPT plan, from the terminal or an MCP client connected to your own server.
Get started · Agent guide · Self-host on Cloudflare · Aircraft coverage · Changelog
Early release, self-hosted, single owner. It works end to end locally and on the self-hosted Cloudflare deployment; the current release is listed in the changelog. Thrust targets are simulation-grade estimates, and no aircraft is verified yet. For flight simulation only: never use any output of this project for real-world flight planning or aircraft operation. See status and limits.
Infinite Flight Agent is for pilots who want to fly real-world schedules without assembling them by hand: finding a flight that actually operates, filling in SimBrief, and working out where to spawn and what thrust to set.
- Fly real flights. It searches live and recent schedules through FlightAware AeroAPI and never invents a flight number. If today's gate isn't assigned yet, it gives the gate from the most recent operation and labels it historical.
- Approve before anything is generated. You see the exact flight, airports, departure time, connection, aircraft and thrust status before a SimBrief plan is generated or a cloud browser is opened. Flight research happens before approval, so FlightAware AeroAPI requests (billed to your key) can occur while it looks for options.
- Get your SimBrief plan generated. After you approve, it fills SimBrief's dispatch form in a cloud browser, reads every field back, and clicks Generate once for that approved revision. It never repeats a Generate whose outcome is uncertain.
- Revise without losing earlier plans. A change to a saved leg becomes a new numbered revision with its own approval, generation and briefing; earlier revisions are kept. When you ask for several numbered revisions, they are completed in order.
- Know your takeoff thrust. N1 targets come from SimBrief's own takeoff solution and the lapse shape of FlyByWire's open A32NX thrust model, each with a range. Aircraft it can't model get a clear "unavailable" instead of a guess.
- Plan whole trips. Each leg of a multi-leg trip is dispatched and kept separately, and must leave at least 45 minutes after the previous leg lands.
- Use it where you already chat. Use the terminal chat, or connect an MCP client such as ChatGPT, Claude or Codex to your self-hosted server (per-client acceptance is still pending).
Every briefing leads with what you set first in the simulator:
| Part | What it tells you |
|---|---|
| Spawn | The gate FlightAware reports, or the most recent operation's gate labeled historical |
| Takeoff thrust | Thrust mode and an N1 target with its range, or "unavailable" and why |
| Flight | The real flight number, codeshares and aircraft, or your private callsign |
| Departure | Scheduled and estimated departure, in local time and UTC |
| SimBrief plan | Runways, aircraft and engine, cruise level, distance, time en route, block fuel and takeoff weight, confirmed against the generated plan |
| Takeoff | Runway, flaps, V-speeds and bleeds from SimBrief's takeoff performance |
**SPAWN:** Gate C28 — used by the most recent completed UA599 (2026-10-30, FlightAware); today's gate is not assigned yet
**TAKEOFF THRUST (simulation-grade estimate):** FLEX, LEAP-1A32: set N1 0.911 x full-thrust N1 (range 0.865-0.948)
**Flight:** UA599 KIAD → KDEN · real aircraft A21N
**Departure:** sched out 2026-11-01 17:20 EST (2026-11-01T22:20:00Z)
**SimBrief plan confirmed:** KIAD 01R -> KDEN 16R · A21N LEAP-1A32 · FL360 · 1259 nm · ETE 03:27:38 · block fuel 11872 kgs
**Takeoff:** rwy 01R · flaps 1 · V1/VR/V2 155/159/161 · bleeds ON
A briefing from a live end-to-end run on October 31, 2026 (registration and codeshares removed).
You need uv, a ChatGPT plan, a FlightAware AeroAPI key (the Personal tier is enough), a SimBrief account with a Navigraph email and password, and a Browserbase API key.
git clone https://github.com/IntelIP/InfiniteFlightAgent.git
cd InfiniteFlightAgent
uv sync --locked
cp .env.example .env # add AEROAPI_KEY, SIMBRIEF_USERID, BROWSERBASE_API_KEY,
# NAVIGRAPH_USERNAME and NAVIGRAPH_PASSWORD
uv run ifd-login # sign in with ChatGPT and approve plan usage
uv run ifd-chat # describe your flightThe cloud browser signs in to SimBrief by itself with your Navigraph email and password and
keeps that login between runs. If you sign in to Navigraph with Google, Apple or Microsoft, set a
Navigraph password first, or run uv run ifd-simbrief to sign in once by hand. Approval prompts
appear in the terminal. The agent guide covers every
setting, resuming conversations, and MCP client setup.
| Path | Best for | Start |
|---|---|---|
| Terminal chat | Trying it out on one machine | uv run ifd-chat |
| Self-hosted remote MCP | The full agent from an MCP client, behind Cloudflare Access | Cloudflare deployment |
| Local SimBrief tools (stdio) | Retrieving, reading and estimating from existing SimBrief plans; no generation | SimBrief tools |
The remote MCP server exposes plan_flight, approve_dispatch, turn_status,
conversation_status, list_saved_trips and browser_status
(tool reference).
It is built for ChatGPT, Claude and Codex as MCP clients; each client's own end-to-end journey
has not yet passed acceptance, so treat client compatibility as unverified until it does.
| Component | Local | Self-hosted on Cloudflare |
|---|---|---|
| Agent and MCP server | Your machine | A Cloudflare Worker and container, signed in through Cloudflare Access |
| Conversations and saved plans | SQLite in data/ |
Neon Postgres |
| Plan screenshots | data/screens/ |
Cloudflare R2 |
| Secrets | .env |
Doppler, synced to Worker secrets on release |
| SimBrief login | Saved Browserbase profile | The same; signs in again on demand when a session finds it signed out |
The self-hosted deployment is built for one owner. It is not a shared or resold service.
flowchart LR
you([You]) -->|"flight idea"| agent["Dispatcher agent<br/>(Deep Agents + your ChatGPT plan)"]
agent -->|"real flights, gates"| fa[(FlightAware AeroAPI)]
agent -->|"approval"| you
agent -->|"fill and generate"| bb["Browserbase cloud browser"] --> sb[(SimBrief)]
sb -->|"OFP + takeoff performance"| agent
agent -->|"spawn + N1 briefing"| you
One agent handles the conversation and the judgment calls. Fixed tools handle everything that must be exact: flight lookup, the approval gate, plan generation, matching the generated plan to its leg, and the thrust estimate. The approval gate refuses a dispatch you shouldn't be asked to approve, such as a leg with no departure time or one that leaves before the previous leg lands. See the agent guide and the technical design.
- Workflow evaluations. 28 whole-conversation scenarios drive the production MCP tools over local HTTP with controlled FlightAware, SimBrief and browser services: planning, routing, provider failures, approved revisions and recovery after a restart. The original eight regression cases stay unchanged alongside them. Controlled-service results, matched replays on the configured model and live-provider runs are reported separately (evaluation guide, v0.4.6 release record).
- Fixes come from traces. For example, WF-025 found that numbered revisions were treated as alternatives; v0.4.6 completes them in order, each separately approved (fix report).
- First-message checks. 100 scripted first messages in 11 categories cover vague requests, multi-leg trips, private flights and unsupported aircraft. The last full runs (October 31, 2026) passed every safety check (results).
- No FlightAware fees for routine runs. Evaluations replay synthetic or recorded FlightAware responses. Live provider checks are opt-in and capped at $1 per batch by default (how to run them).
- Live acceptance per release. Each release candidate's exact image runs a two-leg trip (KIAD→KEWR, then KEWR→KIAD) on a temporary staging Worker, with a separate approval per leg, before production approval. For v0.4.6 each leg generated once, the two browser sessions used 151 seconds in total, and no browser was left running (release record, acceptance data). These are single runs, not performance statistics.
Versions follow Semantic Versioning. Every release has an entry in the
changelog, a vX.Y.Z tag with a
GitHub Release, and a Cloudflare
Worker version with the same name. A running server reports its version at /health.
- Early, personal-use software. It works end to end locally and on the self-hosted Cloudflare deployment, which planned its first live flights on November 1, 2026. Each deployment is built for one owner and is not a shared service.
- One cloud browser at a time. A deployment runs one browser workflow at a time, with up to two waiting for 30 seconds, and each browser session ends within 180 seconds.
- Costs are yours. FlightAware AeroAPI, Browserbase and ChatGPT plan usage are billed to your own accounts. FlightAware research can happen before you approve a dispatch.
- Thrust targets are simulation-grade estimates, shown with a range. No aircraft is yet verified against reference data: 0 of the 51 current Infinite Flight aircraft meet the verified-support criteria (aircraft coverage). The model covers pressure altitudes from -2,000 to 16,600 ft, FlyByWire's full takeoff table. Above 2,000 ft, such as at Denver, the engine's behavior is extrapolated, so the range is wider and large FLEX reductions there may be flagged as suspect.
- FlightAware only sees about two days ahead. Flights further out have no live schedule or gate.
- It does not control the simulator. It never claims your plan was imported, your aircraft spawned, or your thrust was set.
Issues and pull requests are welcome. Read CONTRIBUTING.md for setup, tests, evaluation rules and live acceptance, and the code of conduct. Checks that need no provider keys:
uv run ruff check src tests
uv run pytest -qReport vulnerabilities privately as described in SECURITY.md.
v0.5.0 adds durable trip progress and safe cancellation, more dispatch inputs such as cruise altitude and alternates, sourced private-flight configurations, and measured aircraft expansion. The roadmap and backlog track it.
GPL-3.0-only. The takeoff N1 estimator ports the thrust-limit lapse shape of
FlyByWire A32NX ThrustLimits_A32NX.hpp (GPL-3.0, commit 66021c2), so the whole project is
distributed under the GPL. Bring your own keys and compute: no credentials, hosted service or
ChatGPT plan access are included.
Infinite Flight Agent is an independent project. It is not affiliated with or endorsed by Infinite Flight LLC, FlightAware, SimBrief or Navigraph, Browserbase, OpenAI, or FlyByWire Simulations. All trademarks belong to their owners.