# Installation

The released version of GeoPandas is 0.1. To install the released version, use `pip install geopandas`.

You may install the latest development version by cloning the GitHub repository and using the setup script:

    git clone https://github.com/geopandas/geopandas.git
    cd geopandas
    python setup.py install

It is also possible to install the latest development version available on PyPI with pip by adding the `--pre` flag for pip 1.4 and later, or to use pip to install directly from the GitHub repository with:

    pip install git+git://github.com/geopandas/geopandas.git

## Dependencies

Supports Python versions 2.6, 2.7, and 3.2+.

- numpy
- pandas (version 0.13 or later)
- shapely
- fiona
- six
- geopy 0.99 (optional; for geocoding)
- psycopg2 (optional; for PostGIS connection)

For plotting, these additional packages may be used:

- matplotlib
- descartes
- pysal

## Testing

To run the current set of tests from the source directory, run:

    nosetests -v

from a command line.

Tests are automatically run on all commits on the GitHub repository, including pull requests, on Travis CI.