Skip to main content

Dynamic data analysis over the web. The logic to your data dashboards.

Project description

bamboo is an application that systematizes realtime data analysis. bamboo provides an interface for merging, aggregating and adding algebraic calculations to dynamic datasets. Clients can interact with bamboo through a a REST web interface and through Python.

bamboo supports a simple querying language to build calculations (e.g. student teacher ratio) and aggregations (e.g. average number of students per district) from datasets. These are updated as new data is received.

bamboo is open source software released under the 3-clause BSD license, which is also known as the “Modified BSD License”.


  • python (tested on version 2.7)
  • mongodb

for numpy, pandas, and scipy (in requirements.pip):

on Arch Linux: # pacman -S blas lapack gcc-fortran

on Debian based: # apt-get install gfortran libatlas-base-dev


$ ./scripts/

Running the server

Running the server in the foreground

start mongodb on localhost and standard port

$ python ./scripts/

Running the server as a daemon

start mongodb on localhost and standard port

  1. create a user named ‘bamboo’, with home directory /home/bamboo
  2. create a virtualenv using virtualenvwrapper called ‘bamboo’
  3. place the bamboo root directory in /var/www/bamboo/current

start the daemon using:

$ /var/www/bamboo/current/scripts/ start

stop the daemon using:

$ /var/www/bamboo/current/scripts/ stop

Example Usage

On the remote server

running the example basic commands

$ ./scripts/

using bamboo.JS

var dataset = new bamboo.Dataset({url: ''});

using pybamboo

$ pip install pybamboo
$ python
from pybamboo import PyBamboo
pybamboo = PyBamboo()
response = pybamboo.store_csv_file('')
dataset_id = response['id']

posting a dataset

$ curl -X POST -d "url="

On your local server

start the bamboo server as above, then

run the example basic commands

$ ./scripts/ -l

make requests to your local server

$ curl -X POST -d "url=" http://localhost:8080/datasets


install nose testing requirements

$ pip install -r requirements-test.pip

run tests

$ cd bamboo
$ ../scripts/

or run the profiler

$ cd bamboo
$ ../scripts/ -p


Viewing Documentation

The latest docs are available at

Building Documentation

Install graphviz for class structure diagrams:

on Arch Linux: # pacman -S graphviz

on Debian based: # apt-get install graphviz

$ pip install -r requirements-docs.pip
$ cd docs
$ make html

Contributing Code

To work on the code:

  1. fork this github project
  2. add tests for your new feature
  3. add the code for your new feature
  4. ensure it is pep8
$ pip install pep8
$ pep8 bamboo
  1. ensure all existing tests and your new tests are passing
$ cd bamboo
$ ../scripts/
  1. submit a pull request


bamboo is an open source project. The project features, in chronological order, the combined efforts of

  • Peter Lubell-Doughtie
  • Mark Johnston

and other developers.

Project details

Release history Release notifications

History Node


History Node

History Node


History Node


History Node

This version
History Node

History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
bamboo-data- (60.6 kB) Copy SHA256 hash SHA256 Source None Dec 9, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page