Skip to main content
alpha · 0.1.0

A friendly, modern tool for managing OpenStreetMap data with PostgreSQL

Get Started →★ GitHub
▸ what it does

Project management for your OSM data

01

Project-based workflow

Initialise, save, and check in osmprj.toml alongside your code. Share imports the way you share Cargo.toml.

02

Built on osm2pgsql

A wrapper, not a replacement. Auto-tunes flags for your hardware and initialises replication so subsequent syncs are incremental.

03

Nine built-in themes

Ship with shortbread, pgosm, osmcarto and more. Add your own by extending OSMPRJ_THEME_PATH.

See it in action

Spin up a fresh database with Germany's OSM data in four commands.

~/projects/germany-osmbash
# 1. Create an osmprj.toml in the current directory
$ osmprj init --db "postgres://postgres@localhost/osm"

# 2. Register a Geofabrik region
$ osmprj add germany --theme shortbread
  ✓ schema germany registered

# 3. Check what will be synced
$ osmprj status
  database:  postgres://postgres@localhost/osm  ✓ connected

  source   schema   status
  ------   ------   ------
  germany  germany  ✗  — run 'osmprj sync' to import

# 4. Download and import
$ osmprj sync
  → downloading germany-latest.osm.pbf  [██████████] 4.2 GB

Full walkthrough