Using setuptools

To obtain the latest released version of statsmodels using pip

pip install -U statsmodels

Or follow this link to our PyPI page, download the wheel or source and install.

Statsmodels is also available in through conda provided by Anaconda. The latest release can be installed using

conda install -c conda-forge statsmodels

Obtaining the Source

We do not release very often but the master branch of our source code is usually fine for everyday use. You can get the latest source from our github repository. Or if you have git installed:

git clone git://github.com/statsmodels/statsmodels.git

If you want to keep up to date with the source on github just periodically do:

git pull

in the statsmodels directory.

Windows Nightly Binaries

If you are not able to follow the build instructions below, we occasionally upload builds of the GitHub repository to https://anaconda.org/statsmodels/statsmodels. This version can be installed using conda

conda install -c statsmodels statsmodels=0.8.0_dev

Installation from Source

You will need a C compiler installed to build statsmodels. If you are building from the github source and not a source release, then you will also need Cython. You can follow the instructions below to get a C compiler setup for Windows.


Once you have obtained the source, you can do (with appropriate permissions):

python setup.py install


python setup.py build
python setup.py install


It is strongly recommended to use 64-bit Python if possible.

Python 2.7

Obtain Microsoft Visual C++ Compiler for Python 2.7 and then install using

python setup.py install

Python 3.5

Download and install the most recent version of Visual Studio Community Edition and then install using

python setup.py install

32-bit or other versions of Python

You can build 32-bit version of the code on windows using mingw32.

First, get and install mingw32. Then, you’ll need to edit distutils.cfg. This is usually found somewhere like C:Python27Libdistutilsdistutils.cfg. Add these lines:


Then in the statsmodels directory do:

python setup.py build
python setup.py install


You can build 32-bit Microsoft SDK. Detailed instructions can be found on the Cython wiki here. The gist of these instructions follow. You will need to download the free Windows SDK C/C++ compiler from Microsoft. You must use the Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1 to be comptible with Python 2.7, 3.1, and 3.2. The link for the 3.5 SP1 version is


For Python 3.3, you need to use the Microsoft Windows SDK for Windows 7 and .NET Framework 4, available from


For 7.0, get the ISO file GRMSDKX_EN_DVD.iso for AMD64. After you install this, open the SDK Command Shell (Start -> All Programs -> Microsoft Windows SDK v7.0 -> CMD Shell). CD to the statsmodels directory and type:


To build a 64-bit application type:

setenv /x64 /release

To build a 32-bit application type:

setenv /x86 /release

The prompt should change colors to green. Then proceed as usual to install:

python setup.py build
python setup.py install

For 7.1, the instructions are exactly the same, except you use the download link provided above and make sure you are using SDK 7.1.

If you want to accomplish the same without opening up the SDK CMD SHELL, then you can use these commands at the CMD Prompt or in a batch file.:

setlocal EnableDelayedExpansion
CALL "C:\Program Files\Microsoft SDKs\Windows\v7.0\Bin\SetEnv.cmd" /x64 /release

Replace /x64 with /x86 and v7.0 with v7.1 as needed.


statsmodels 0.8 was tested with the following minimal version requirements. However, some features require more recent versions.

  • Python >= 2.6, including Python 3.x
  • NumPy >= 1.6
  • SciPy >= 0.11
  • Pandas >= 0.12
  • Patsy >= 0.2.1
  • Cython >= 0.24 is required to build the code from github but not from a source distribution. Earlier versions may work, although you must use Cython >= 0.20.1 if you’re on Python 3.4.

Optional Dependencies

  • Matplotlib >= 1.3 is needed for plotting functions and running many of the examples.
  • If installed, X-12-ARIMA or X-13ARIMA-SEATS can be used for time-series analysis.
  • Nose is required to run the test suite.
  • IPython >= 3.0 is required to build the docs locally or to use the notebooks.

© 2009–2012 Statsmodels Developers
© 2006–2008 Scipy Developers
© 2006 Jonathan E. Taylor
Licensed under the 3-clause BSD License.