dvcrn KnowAir Forecast — Hourly & Daily Weather Forecasts
Query detailed hourly and daily weather forecasts for any location using the Caiyun Weather API.
Prerequisites
- A valid Caiyun Weather API token set as
CAIYUN_TOKENenvironment variable, or stored in~/.config/knowair/token. - Coordinates (longitude, latitude) for the target location.
Quick Start
python3 scripts/query_forecast.py --lng 116.3176 --lat 39.9760 --type daily --days 7
Workflow
- Resolve coordinates — convert city name to longitude and latitude if needed.
- Choose forecast type —
hourlyordaily. - Run the script:
python3 scripts/query_forecast.py --lng <LNG> --lat <LAT> --type <TYPE> - Present results — highlight temperature ranges, precipitation probability, and notable weather changes.
Options
| Flag | Description | Default |
|---|---|---|
--lng |
Longitude (-180 to 180) | Required |
--lat |
Latitude (-90 to 90) | Required |
--type |
hourly or daily |
daily |
--hours |
Hours to forecast (1-360, hourly mode) | 48 |
--days |
Days to forecast (1-15, daily mode) | 7 |
--detail-level |
Display density 0-6 (0=auto, 1=every hour, etc.) | 0 |
--lang |
Output language: en or zh |
en |
Defaults
- Forecast type:
daily - Days: 7, Hours: 48
- Detail level: auto (0)
- Language:
en
Failure Handling
- Missing token → exit code 2 with setup instructions.
- API error → exit code 1 with error details.
- Network unreachable → suggest the user check connectivity.
Additional Resources
- examples.md — usage examples