# Installation

There are different options on how to install a Python package, mostly depending on your preferred tools and what you want to do with it. The easiest way is in most cases to use pip (see below).

## Requirements

pyDataverse officially supports Python 3.6–3.8

Python packages required:

- requests>=2.12.0

- jsonschema>=3.2.0

External packages required:

- curl (only for `replace_datafile()` necessary)

Installer requirements: setuptools

## Pip

To install the latest release of pyDataverse from PyPI, simply run this pip command in your terminal of choice:

    pip install -U pyDataverse

## Pipenv

Pipenv combines pip and virtualenv.

    pipenv install pyDataverse

## Conda

pyDataverse is also available through conda-forge.

    conda install pyDataverse -c conda-forge

## Source Code

PyDataverse is actively developed on GitHub, where the code is always available.

You can either clone the public repository:

    git clone git://github.com/gdcc/pyDataverse.git

Or download the archive of the `master` branch as a zip:

    curl -OL https://github.com/gdcc/pyDataverse/archive/master.zip

Once you have a copy of the source, you can embed it in your own Python package:

    cd pyDataverse
    pip install .

## Development

To set up your development environment, see Creating a development environment.