Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

109 lines (66 sloc) 2.713 kb
Installing CoLab
for local development
CoLab requires...
- Python 2.3 (maybe 2.4). I recommend using 2.6 because why not?
- Django 1.2
- Pinax 0.9
- MathJax
- TinyMCE
Getting a local copy running isn't the simplest thing right now. Eventually we will have a buildout script to do all of this. Babysteps.
First you need to make sure Python is installed and works. Hopefully, you are using something easy like Ubuntu and you can run a simple
$ sudo apt-get install python2.6
$ python
Python 2.6.4 (r264:75706, Dec 7 2009, 18:45:15)
[GCC 4.4.1] on linux2
Type "help", "copyright", "credits" or "license" for more information.
Python package tools
Python has two package management tools that make your life very easy. They are called easy_install and pip. I think pip is better, but it doesn't really matter. Do a
$ sudo apt-get install python-setuptools
$ sudo apt-get install python-pip
to install both. Now you can install any python package you want using
$ sudo pip install whatever
$ sudo easy_install whatever
Yay python.
Virtualenv and virtualenvwrapper
I highly recommend using virtualenvwrapper in order to isolate the colab project from your other python environments. First get virtualenv and then virtualenvwrapper.
$ sudo pip install virtualenv virtualenvwrapper
Now you need a place to put your virtualenvs. The default is ~/.virtualenvs.
$ cd
$ mkdir .virtualenvs
After that, you need to set your WORKON_HOME to tell virtualenvwrapper where to
look. Put this at the end of your ~/.bashrc
export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/
or whatever the path is to or virtualenvwrapper_bashrc on your system. Now you should make an environment for colab.
$ mkvirtualenv colab_dev
If you plan on commiting back to the main GitHub repo, you can either fork the project upfront or use
$ git clone git://
and upload it to GitHub later.
Django and Pinax
In the colab directory, run
(colab)$ pip install Pinax
(colab)$ pip install -r requirements.txt
I couldn't include MathJax in the repo because there are too many files. It's easy to install. In colab/colab/media...
$ svn co mathjax
$ cd mathjax
$ unzip
Download and unzip the tiny_mce directory (not tinymce) to colab/colab/media
Jump to Line
Something went wrong with that request. Please try again.