Sovereign weather forecasts for anywhere on the planet. Use our hosted API for convenience, or run the whole thing on your own servers. The code is open and the data is public.
BUILT BY SIMILIE · THE SAME ENGINE BEHIND OUR FLOOD EARLY WARNING IN TIMOR-LESTE
Ask by coordinates or by place name. Get the weather as data, as a map layer, or as an alert when a threshold is crossed.
Current conditions, an hourly timeline and daily summaries in the place’s local time zone. Hourly for five days, then three-hourly out to sixteen.
Standard XYZ tiles that drop into MapLibre, Leaflet or Mapbox, plus compact raw fields for WebGL layers and analysis.
Define the conditions and the area. Each new model run is checked, and a signed webhook fires when your threshold is crossed.
A Model Context Protocol server lets AI assistants look up forecasts and places directly.
Governments, agencies and utilities shouldn’t have to depend on a black box for forecasts. 4Shadow is built from public NOAA model data and open code, so you can use it as a service today and bring it in-house whenever you need to.
Get a free key at 4shadow.io and make your first request. We run the ingest, the storage and the uptime. Paid plans add volume and early warnings.
The forecast service is open source (GPL-3.0). It needs no database: a Docker compose file starts the API and a continuous ingest that follows NOAA’s four daily runs. Keep the data, the keys and the uptime on your own infrastructure.
The client library speaks to either. Build against our hosted API now and point it at your own server later, or the other way round. Each model run is published whole, so you never get a mix of two.
The TypeScript SDK runs in Node and in the browser. Ask for Dili by name and get the forecast back in local time.
$ npm install @similie/4shadow
import { ForeshadowClient, dailyRows } from "@similie/4shadow";
const client = new ForeshadowClient({
apiKey: process.env.FORESHADOW_API_KEY,
});
const forecast = await client.forecast("Dili, Timor-Leste", { hours: 48 });
for (const day of dailyRows(forecast)) {
console.log(day.date, day.t2m_min, day.t2m_max, day.precip_sum);
}
FastAPI, NumPy and NOAA’s GFS and GFS-Wave models. Point forecasts, tiles, raw fields, offline place search, early warnings and the MCP server. Includes a deployment guide for a production server.
The typed client, webhook verification, and a SvelteKit map app you can deploy yourself, with a Docker guide.
FORECAST DATA: NOAA/NCEP GFS AND GFS-WAVE (PUBLIC DOMAIN). PLACE NAMES: GEONAMES (CC BY 4.0). THE HOSTED SERVICE AT 4SHADOW.IO HAS ITS OWN TERMS, SEPARATE FROM THE OPEN-SOURCE LICENCES.
Planning a national deployment, or want help hosting it yourself? Talk to us.