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


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


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


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.


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

git clone 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 develop

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