Create an ETL project

If you only want to use Bonobo to code ETLs, your easiest option to get started is to use our cookiecutter template.

Install from PyPI

You can also install it directly from the Python Package Index.

$ pip install bonobo

Install from source

If you want to install an unreleased version, you can use git urls with pip. This is useful when using bonobo as a dependency of your code and you want to try a forked version of bonobo with your software. You can use the git+http string in your requirements.txt file. However, the best option for development on bonobo directly is not this one, but editable installs (see below).

$ pip install git+

Editable install

If you plan on making patches to Bonobo, you should install it as an “editable” package, which is a really great pip feature. Pip will clone your repository in a source directory and create a symlink for it in the site-package directory of your python interpreter.

$ pip install --editable git+


You can also use the -e flag instead of the long version.

If you can’t find the “source” directory, try trunning this:

$ python -c "import bonobo; print(bonobo.__path__)"

Another option is to have a “local” editable install, which means you create the clone by yourself and make an editable install from the local clone.

$ git clone
$ cd bonobo
$ pip install --editable .

You can develop on this clone, but you probably want to add your own repository if you want to push code back and make pull requests. I usually name the git remote for the main bonobo repository “upstream”, and my own repository “origin”.

$ git remote rename origin upstream
$ git remote add origin

Of course, replace my github username by the one you used to fork bonobo. You should be good to go!

Windows support

There are problems on the windows platform, mostly due to the fact bonobo was not developed by experienced windows users.

We’re trying to look into that but energy available to provide serious support on windows is very limited. If you have experience in this domain and you’re willing to help, you’re more than welcome!


Better install docs, especially on how to use different forks or branches, etc.