Aviation weather briefing and FAA reference assistant for pilots. Fetches real-time METAR, TAF, and PIREPs from aviationweather.gov (no API key required). Provides FAR Part 61/91 quick reference, VFR/IFR weather minimums, and go/no-go decision support. Use when user asks about METAR, TAF, PIREP, aviation weather, can I fly today, VFR/IFR conditions, flight weather briefing, FAR regulations for pilots, PPL/IFR training weather, or queries with ICAO airport codes.
Aviation weather briefing and FAA reference assistant. Fetches live weather data from aviationweather.gov and provides FAR/AIM quick reference for flight planning and go/no-go decisions.
# Get current METAR for Los Angeles International
python3 scripts/metar.py --metar KLAX
# Full briefing: METAR + TAF forecast for two airports
python3 scripts/metar.py --metar KLAX KSFO --taf KLAX KSFO
# Check PIREPs (pilot reports) near Chicago O'Hare, last 4 hours
python3 scripts/metar.py --pirep KORD --hours 4
Queries the aviationweather.gov public API (no API key needed). Returns formatted, decoded weather reports with flight category classification.
| Flag | Description | Example |
|---|---|---|
--metar ICAO [ICAO ...] |
| Fetch current METAR for one or more airports |
--metar KLAX KJFK |
--taf ICAO [ICAO ...] | Fetch TAF forecast for one or more airports | --taf KORD |
--pirep ICAO | Fetch PIREPs within 200 nm of airport | --pirep KSFO |
--hours N | Hours of data to retrieve (1-24, default: 2) | --hours 6 |
Flags can be combined in a single call:
python3 scripts/metar.py --metar KLAX --taf KLAX --pirep KLAX --hours 3
+TSRA -> Heavy Thunderstorm Rain)Codes must be exactly 4 uppercase letters. Common US airports use K prefix (e.g., KLAX, KJFK, KORD). International examples: EGLL (London Heathrow), RJTT (Tokyo Haneda).
| User Question | Read This File |
|---|---|
| "What does BKN025 mean?" / "Decode this METAR" | references/metar-codes.md |
| "What does TEMPO mean in this TAF?" / "Explain TAF format" | references/taf-codes.md |
| "How many landings do I need to be current?" / "What are VFR minimums in Class D?" | references/far-quickref.md |
| "Can I fly today?" / "Is this weather safe for a student pilot?" | references/decision-guide.md |
| Go/no-go decision with specific weather data | Run scripts/metar.py first, then read references/decision-guide.md |
For a full weather briefing workflow:
scripts/metar.py with --metar and --taf for the departure and destination airportsscripts/metar.py with --pirep to check for turbulence/icing reportsreferences/decision-guide.md to evaluate the weather against personal minimumsreferences/far-quickref.md if the user needs regulatory specifics| Category | Ceiling | Visibility | Marker | Meaning |
|---|---|---|---|---|
| VFR | > 3,000 ft AGL | > 5 SM | Green | Visual flight rules — clear conditions |
| MVFR | 1,000 – 3,000 ft | 3 – 5 SM | Blue | Marginal VFR — proceed with caution |
| IFR | 500 – 999 ft | 1 – < 3 SM | Red | Instrument flight rules required |
| LIFR | < 500 ft | < 1 SM | Magenta | Low IFR — extremely restricted visibility |
The more restrictive of ceiling or visibility determines the category. For example, 10 SM visibility but a 900 ft ceiling is IFR (ceiling is the limiting factor).
Ceiling is defined as the lowest cloud layer reported as BKN (Broken) or OVC (Overcast). FEW and SCT layers are not ceilings.