Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tree: f1b14f3d13
Fetching contributors…

Cannot retrieve contributors at this time

76 lines (41 sloc) 3.07 KB
layout title
Installing on Mac OS X

Return to Docs

Installing on Mac OS X

Before installing Kartograph, please install the GDAL Complete Framework as provided by William Kyngesburye on

I recommend to install Kartograph in its own virtualenv. Otherwise you need to sudo every pip call.

Install required Python packages needs a couple of Python packages. You can install them all at once using:

pip install -r

Alternative way if GDAL install fails

Some users reported that the install of the GDAL package fails on OSX. The way around this issue is to use the pre-compiled package included in GDAL Complete Framework, which you already installed.

You need to include their location in your PYTHONPATH environment variable. This can be done either in the activate script of your virtualenv or in your favorite shell startup file (.bashrc, .profile, etc.).

export PYTHONPATH=$PYTHONPATH:/Library/Frameworks/GDAL.framework/Versions/1.9/Python/2.7/site-packages

Then use requirements-nogdal.txt to install all required packages except GDAL.

pip install -r


Then you should be ready to install Kartograph using:

pip install

Test Installation

Download the 1:50m Admin 0 Countries shapefile from Natural Earth into a newly created folder "kartograph-test" in your home folder.

mkdir ~/kartograph-test
cd ~/kartograph-test;

Create a very basic map configuration by creating a new text file named "world.json" and paste the following content into it:

   "layers": [{
       "src": "ne_50m_admin_0_countries.shp"

Then you create the map using the following command:

kartograph world.json -o world.svg

Congrats, that's it. Here's what you should see now.

resulting map

There are more tests included in the repository on Github.


  • Speaking about shapely, this installation guide might help you getting it running on Mac OS.
  • During the install Python will need to compile packages, make sure that you have a working compiler on your system. Installing XCode with the Command line Utils helps.

Do you want to improve this installation instructions? Please, drop me an email.

Jump to Line
Something went wrong with that request. Please try again.