Repository navigation
Releases
v0.5.0 — schools across Africa (54 countries)
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)
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)
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 eachmanifest.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
Second country, first service layer, live map.
What's new
- Mozambique joins Malawi — the second country needed zero code
changes, justprofiles/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
andfacilities_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 facilitiesmoz-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
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 checksumsquality_report.json— 15 automated checks, all passing- Map viewer —
index.htmlchoropleth with legend and per-district popups; serve locally withcbk 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.