version · 0.3.0
A friendly, modern CLI for working with OpenStreetMap data in PostgreSQL
Install with the following command:
curl -fsSL https://osmprj.dev/install.sh | bash
Want even more installation methods? See here.
▸ 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
Create a database with various Geofabrik regions in three commands.
# 1. Initialize your project
osmprj init --db postgres://user@host:5432/db
Created osmprj.toml
# 2. Add sources to your project and choose a theme
osmprj add bremen --theme shortbread
...
osmprj add hamburg --theme pgosm
...
# 3. Sync your project by downloading importing to PostgreSQL
osmprj sync
...
🌐 Sync complete. 0 sources updated, 2 sources newly imported.
Full walkthrough
See the entire process of initializing and syncing an osmprj project.