Installation

Users

csvkit is works on Python versions 2.6, 2.7, 3.3 and 3.4, as well as PyPy. It is supported on OSX and Linux. It also works–but is tested less frequently–on Windows.

Installing csvkit is simple:

pip install csvkit

Note

If you are installing on Ubuntu you may need to install the Python development headers prior to install csvkit:

sudo apt-get install python-dev python-pip python-setuptools build-essential

Note

If the installation appears to be successful but running the tools fails, try updating your version of Python setuptools:

pip install --upgrade setuptools
pip install --upgrade csvkit

Note

If you are using Python2 and have a recent version of pip, you may need to run pip with the additional arguments --allow-external argparse.

Developers

If you are a developer that also wants to hack on csvkit, install it this way:

git clone git://github.com/onyxfish/csvkit.git
cd csvkit
mkvirtualenv csvkit

# If running Python 2
pip install -r requirements-py2.txt

# If running Python 3
pip install -r requirements-py3.txt

python setup.py develop
tox

Before writing any code be sure to read the documentation for Contributing to csvkit.