Run in your terminal:
easy_install -U gensim
pip install --upgrade gensim
In case that fails, make sure you’re installing into a writeable location (or use sudo), or read on.
Gensim is known to run on Linux, Windows and Mac OS X and should run on any other platform that supports Python 2.5 and NumPy. Gensim depends on the following software:
Windows users are well advised to try the Enthought distribution, which conveniently includes Python & NumPy & SciPy in a single bundle, and is free for academic use.
Check what version of Python you have with:
You can download Python from http://python.org/download.
Gensim requires Python 2.5 or greater and will not run under earlier versions.
Next, install the easy_install utility, which will make installing other Python programs easier.
These are quite popular Python packages, so chances are there are pre-built binary distributions available for your platform. You can try installing from source using easy_install:
easy_install numpy easy_install scipy
If that doesn’t work or if you’d rather install using a binary package, consult http://www.scipy.org/Download.
You can now install (or upgrade) gensim with:
easy_install --upgrade gensim
That’s it! Congratulations, you can proceed to the tutorials.
If you also want to run the algorithms over a cluster of computers, in Distributed Computing, you should install with:
The optional distributed feature installs Pyro (PYthon Remote Objects). If you don’t know what distributed computing means, you can ignore it: gensim will work fine for you anyway. This optional extension can also be installed separately later with:
There are also alternative routes to install:
python setup.py install
to install gensim into your site-packages folder.
If you wish to make local changes to the gensim code (gensim is, after all, a package which targets research prototyping and modifications), a preferred way may be installing with:
python setup.py develop
This will only place a symlink into your site-packages directory. The actual files will stay wherever you unpacked them.
If you don’t have root priviledges (or just don’t want to put the package into your site-packages), simply unpack the source package somewhere and that’s it! No compilation or installation needed. Just don’t forget to set your PYTHONPATH (or modify sys.path), so that Python can find the unpacked package when importing.
To test the package, unzip the tar.gz source and run:
python setup.py test