Fetching contributors…
Cannot retrieve contributors at this time
128 lines (76 sloc) 3.62 KB


Provides Python bindings for the Libosmium C++ library, a library for working with OpenStreetMap data in a fast and flexible manner.

Travis Build Status Appveyor Build Status


Python >= 2.7 is supported but a version >= 3.3 is strongly recommended.

Other requirements are:

You have to compile with the same compiler version that Python is compiled with on your system, otherwise it might not work.


On Debian/Ubuntu systems all required dependencies can be installed with:

sudo apt-get install build-essential libboost-python-dev \
                     libexpat1-dev zlib1g-dev libbz2-dev

Homebrew (OS X)

On OS x Boost.Python needs to be installed with brew install boost-python or brew install boost-python3 depending on which Python version you want to use. You can also (re)install both.


Using Pip

The recommended way to install pyosmium is via pip:

pip install osmium

There are also experimental binary wheels for Windows available.

Compiling from Source

When compiling from source, you need to get the latest libosmium version first. It is recommended to put it next to the pyosmium source. The setup script uses per default either a globally installed libosmium or looks for the source in ../libosmium. You can set a custom location with LIBOSMIUM_PREFIX.

To use a custom boost installation, set BOOST_PREFIX.

To compile the bindings, run

python build

To compile and install the bindings, run

python install --user

to install only for your user, or

python install

to install globally.


The example directory contains small examples on how to use the library. They are mostly ports of the examples in Libosmium and osmium-contrib.


There is a small test suite in the test directory. This provides regression test for the python bindings, it is not meant to be a test suite for Libosmium.

You'll need the Python nose module. On Debian/Ubuntu install the package python-nose. For Python2 mock is required as well (package python-mock).

The suite can be run with:

cd test


To build the documentation you need Sphinx and the autoprogram extension On Debian/Ubuntu install python-sphinx sphinxcontrib-autoprogram or python3-sphinx python3-sphinxcontrib.autoprogram.

First compile the bindings as described above and then run:

cd doc
make html

For building the man pages for the tools run:

cd doc
make man

Bugs and Questions

If you find bugs or have feature requests, please report those in the github issue tracker.

For general questions about using pyosmium you can use the OSM development mailing list or ask on OSM help.


Pyosmium is available under the BSD 2-Clause License. See LICENSE.TXT.


Sarah Hoffmann (