4SHADOWOPEN SOURCE

Every point on Earth.
Your forecast.

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.

Get a free API key→ Host your own

BUILT BY SIMILIE · THE SAME ENGINE BEHIND OUR FLOOD EARLY WARNING IN TIMOR-LESTE

4SHADOW · GFS4 RUNS A DAY
One request.
Hourly to 16 days.
  • → 25 variables: temperature, wind, rain, cloud, pressure, waves and swell
  • → Point forecasts, map tiles and raw grids
  • → Early-warning alerts with signed webhooks
  • → An MCP endpoint for AI assistants
WHAT YOU GET

Forecasts you can
build on.

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.

01 · POINT FORECASTS
Any place, any hour.

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.

02 · MAPS
Tiles and raw grids.

Standard XYZ tiles that drop into MapLibre, Leaflet or Mapbox, plus compact raw fields for WebGL layers and analysis.

03 · EARLY WARNING
Told before it hits.

Define the conditions and the area. Each new model run is checked, and a signed webhook fires when your threshold is crossed.

04 · MCP
Weather for your AI.

A Model Context Protocol server lets AI assistants look up forecasts and places directly.

SOVEREIGN BY DESIGN

Your weather data,
under your control.

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.

USE OUR API
Start in minutes.

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.

Open 4shadow.io→
HOST YOUR OWN
Run it yourself.

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.

See the code→
MOVE EITHER WAY
No lock-in.

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.

FOR DEVELOPERS

A typed client,
zero dependencies.

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);
}
OPEN SOURCE

Read it. Run it.
Change it.

4SHADOW-APIGPL-3.0 · PYTHON
The forecast service.

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.

View on GitHub→
4SHADOW-JSMIT · TYPESCRIPT
The SDK and the map.

The typed client, webhook verification, and a SvelteKit map app you can deploy yourself, with a Docker guide.

View on GitHub→

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.

Weather,
on your terms.

Planning a national deployment, or want help hosting it yourself? Talk to us.

Talk to Similie→Get an API key