Skip to content

Releases

v0.5.0 — schools across Africa (54 countries)

Choose a tag to compare

@alfredshingai alfredshingai released this 01 Nov 13:45

Schools across Africa.

Every country baseline now includes its school network —
school_count and schools_per_10k_pop per admin unit, from HOT's OSM
education-facilities extracts (ODbL; points stay in a separate table).
354,577 schools counted across 54 countries.

Also in this release:

  • Facilities and schools share a generic point-count join in the
    pipeline — each new point layer is now a three-line addition.
  • The 54-country rebuild wave completed without a single network
    failure — the retry-hardened download layer held up end to end.
  • A "Schools /10k" field joins the live map:
    https://alfredshingai.dev/crisis-baseline-kit/

The attached bundles

54 full-resolution country bundles (2.1 GB total): GeoPackage (admin
boundaries + facilities + roads + schools), GeoParquet tables, GeoJSON,
provenance manifest with per-layer licenses and SHA-256 checksums, and
quality report. Raw sources are re-downloadable via the URLs recorded
in each manifest.json.

Coverage: all African countries except Mauritius (its COD-AB publishes
only image files).

Reproduce

pip install -e .
cbk selftest
cbk build MWI    # or any ISO3 in profiles/
cbk diff MWI     # change report between the two latest bundles

Sources & licenses

WorldPop (CC-BY 4.0) · OCHA COD-AB via HDX (CC BY-IGO) · healthsites.io
via HDX (ODbL, separate table) · OpenStreetMap + HOT education
facilities via Geofabrik/HDX (ODbL, separate tables) · code MIT.
Policy:
docs/sources.md.

v0.4.0 — roads across Africa (54 countries)

Choose a tag to compare

@alfredshingai alfredshingai released this 31 Oct 22:06

Roads across Africa.

Every country baseline now includes its major-road network —
kilometers of motorway-through-tertiary roads per admin unit (and per
100 km²), extracted from OpenStreetMap via Geofabrik country extracts.
OSM geometry stays in a separate ODbL table in each bundle; only the
aggregates join the admin data.

Highlights: Nigeria 121,007 km across its 774 LGAs, Mozambique
36,446 km across 161 districts, Kenya 290 units, Algeria 1,541 communes.

Also new:

  • cbk diff — compares a country's two latest bundles and writes a
    per-unit change report. The weekly CI rebuilds now accumulate
    comparable baselines, so "what changed this month" becomes a command.
  • Roads-density field added to the live map and bundle viewers:
    https://alfredshingai.dev/crisis-baseline-kit/
  • Download retries with backoff (the 53-country rebuild rode out several
    upstream connection-drop episodes).

The attached bundles

54 full-resolution country bundles (2.0 GB total): GeoPackage (admin
boundaries + facilities + roads), GeoParquet tables, GeoJSON, provenance
manifest with per-layer licenses and SHA-256 checksums, and quality
report. Raw sources are re-downloadable via the URLs recorded in each
manifest.json.

Coverage: all African countries except Mauritius (its COD-AB publishes
only image files). Western Sahara ships without the roads layer (no
separate OSM extract).

Reproduce

pip install -e .
cbk selftest
cbk build MWI    # or any ISO3 in profiles/
cbk diff MWI     # change report between the two latest bundles

Sources & licenses

WorldPop (CC-BY 4.0) · OCHA COD-AB via HDX (CC BY-IGO) · healthsites.io
via HDX (ODbL, separate table) · OpenStreetMap via Geofabrik (ODbL,
separate table) · code MIT. Policy:
docs/sources.md.

v0.3.0 — Africa-wide coverage (54 countries)

Choose a tag to compare

@alfredshingai alfredshingai released this 25 Oct 16:13

Africa-wide coverage.

54 country baselines — every African country with buildable public
sources — OCHA COD-AB boundaries, WorldPop 2020 population (100 m), and
healthsites.io facility counts, each one quality-gated (admin-unit counts
pinned from verified builds; population bands around UN 2020 estimates)
and committed one country at a time.

  • Live map (searchable, all countries):
    https://alfredshingai.dev/crisis-baseline-kit/
  • Downloads: 54 full-resolution bundles attached to this release
    (GeoPackage + GeoParquet + GeoJSON + provenance manifest + quality
    report each). Raw source rasters/archives are re-downloadable via the
    URLs and SHA-256 checksums recorded in each manifest.json.

Highlights since v0.2.0

  • COD-AB adapter hardened for the real world: ranked multi-resource
    fallback (Lesotho), per-level zip packages via union extraction
    (Tanzania), ESRI geodatabase reading, junk-format demotion.
  • Stats level generalized — São Tomé and Western Sahara build at
    admin-1, their deepest available level.
  • Live map UI rebuilt: searchable country sidebar, field switcher
    (population / density / facilities per 10k), hover highlight,
    richer popups, keyless Esri light basemap.
  • CI: per-country parallel matrix; weekly rebuilds keep every baseline
    and the live map current.

Sources & licenses

WorldPop (CC-BY 4.0) · OCHA COD-AB via HDX (CC BY-IGO) · healthsites.io
via HDX (ODbL, separate table) · code MIT. Per-layer terms in every
bundle's manifest.json; policy in
docs/sources.md.

Not included: Mauritius — its COD-AB publishes only image files, no
vector data.

v0.2.0 — Mozambique, health facilities, live map

Choose a tag to compare

@alfredshingai alfredshingai released this 25 Oct 00:30

Second country, first service layer, live map.

What's new

  • Mozambique joins Malawi — the second country needed zero code
    changes, just profiles/MOZ.yaml: 11 provinces, 161 districts,
    national population 31.0M, and an Africa equal-area CRS because the
    country spans two UTM zones.
  • Health facilities — every admin-2 unit now carries facility_count
    and facilities_per_10k_pop, from healthsites.io via HDX (1,166
    facilities in Mozambique, 318 in Malawi; ODbL — facility points stay in
    their own table, only counts join the boundary data).
  • Live map — https://alfredshingai.dev/crisis-baseline-kit/ — a
    country-switching choropleth, auto-published from the weekly CI rebuild.

The attached bundles

  • mwi-baseline-2026-10-25.zip (147 MB) — Malawi: 32 admin-2 units,
    18.2M population, 318 facilities
  • moz-baseline-2026-10-25.zip (527 MB) — Mozambique: 161 admin-2 units,
    30.9M population, 1,166 facilities

Each contains GeoPackage + GeoParquet + GeoJSON, the map viewer,
manifest.json (per-layer source URLs, licenses, versions, SHA-256
checksums) and quality_report.json (all checks passing).

Reproduce

pip install -e .
cbk selftest
cbk build MWI    # or MOZ
cbk serve MWI

Sources & licenses

WorldPop (CC-BY 4.0) · OCHA COD-AB via HDX (CC BY-IGO) · healthsites.io
via HDX (ODbL; separate table) · code MIT. Full policy:
docs/sources.md.

v0.1.0 — Malawi pilot

Choose a tag to compare

@alfredshingai alfredshingai released this 24 Oct 23:43

First release: the Malawi pilot.

One command builds a documented, quality-gated pre-crisis baseline for a
country from public data. This release ships the toolkit and the first
real baseline bundle for Malawi.

The attached bundle — mwi-baseline-2026-10-25.zip (~147 MB)

  • Admin 0/1/2 boundaries with p-codes — OCHA COD-AB via HDX (CC BY-IGO): 1 country, 3 regions, 32 admin-2 units
  • Population — WorldPop 2020 raster, 100 m (CC-BY 4.0), national total ~18.5M
  • Zonal statistics per district — population, area, density (e.g. Lilongwe City 3,306/km² vs rural Mzimba 100/km²)
  • manifest.json — full provenance: source URLs, licenses, versions, retrieval times, SHA-256 checksums
  • quality_report.json — 15 automated checks, all passing
  • Map viewer — index.html choropleth with legend and per-district popups; serve locally with cbk serve (basemap tiles are fetched from the internet)
  • Raw source files — the original downloads are kept in raw/ with checksums

Reproduce it

pip install -e .
cbk selftest        # synthetic end-to-end test, no network
cbk build MWI       # rebuild the bundle from live sources
cbk serve MWI       # view the map

Sources & licenses

WorldPop (CC-BY 4.0) · OCHA COD-AB via HDX (CC BY-IGO) · code MIT.
Per-layer terms are recorded in each bundle's manifest.json — see
docs/sources.md in the repo for the full policy.