Table Of Contents

This Page


The short version

Install it with easy_install

$ sudo easy_install -U luban


get luban from the Python Package Index, expand it and run

$ sudo python install

Or if you need more details:

Install luban using easy_install


Luban is installable on unix/linux platforms, as well as Mac OS X operating systems. Luban has not been tested in windows system.

Please make sure your system has the following software installed:

  1. Python (version 2.x)
  2. setuptools.
  3. (optional, only needed if you want to run native wx application) wx python

Platform-specific instructions

Mac OS X 10.5.x and 10.6.x
  • python: Mac OSX comes with python pre-installed. You can also install the more recent python version from python website.
  • setuptools: Following instructions are copied from setuptools website
  1. Download the appropriate egg for your version of Python (e.g. setuptools-0.6c11-py2.6.egg). Do NOT rename it.

  2. Run it as if it were a shell script, e.g.

    $ sh setuptools-0.6c11-py2.6.egg

    Setuptools will install itself using the matching version of Python (e.g. python2.6), and will place the easy_install executable in the default location for installing Python scripts (as determined by the standard distutils configuration files, or by the Python installation).

Ubuntu 8.x and 9.x
  • python Ubuntu 8.x and 9.x are preinstalled with python.
  • setuptools

We can intall setuptools by:

$ sudo apt-get install python-setuptools
  • (optional) wxpython:

    $ sudo apt-get install python-wxgtk2.8 python-wxtools wx2.8-i18n



$ sudo easy_install luban

To start playing with luban, please read tutorials.