The SymPy CAS can be installed on virtually any computer with Python 2.5 or above. SymPy does not require any special Python modules: let us know if you have any problems with SymPy on a standard Python install. The current recommended method of installation is directly from the source files. Alternatively, executables are available for Windows, and some Linux distributions have SymPy packages available.


SymPy currently recommends that users install directly from the source files. You will first have to download the source files via the archive. Download the latest release (tar.gz) from the downloads site and open it with your operating system’s standard decompression utility.

When downloading the archive, make sure to get the correct version (Python 2 or Python 3). If you’re not sure which one to use, you probably want the Python 2 version. Note that you can install both if you want.

After the download is complete, you should have a folder called “sympy”. From your favorite command line terminal, change directory into that folder and execute the following:

$ python install

Alternatively, if you don’t want to install the package onto your computer, you may run SymPy with the “isympy” console (which automatically imports SymPy packages and defines common symbols) by executing within the “sympy” folder:

$ ./bin/isympy

You may now run SymPy statements directly within the Python shell:

>>> from __future__ import division
>>> from sympy import *
>>> x, y, z, t = symbols('x y z t')
>>> k, m, n = symbols('k m n', integer=True)
>>> f, g, h = symbols('f g h', cls=Function)
>>> print diff(x**2/2, x)


If you are a developer or like to get the latest updates as they come, be sure to install from git. To download the repository, execute the following from the command line:

$ git clone git://

Then, execute either the or the bin/isympy scripts as demonstrated above.

To update to the latest version, go into your repository and execute:

$ git pull origin master

If you want to install SymPy, but still want to use the git version, you can run from your repository:

$ develop

This will cause the installed version to always point to the version in the git directory.

If you’re using the git repository with Python 3, you have to use the ./bin/use2to3 script to build the Python 3 version of SymPy. This will put everything in the py3ksympy directory.

Other Methods

An installation executable is available for Windows users at the downloads site (.exe). In addition, various Linux distributions have SymPy available as a package. Others are strongly encouraged to download from source (details above).

Run SymPy

After installation, it is best to verify that your freshly-installed SymPy works. To do this, start up Python and import the SymPy libraries:

$ python
>>> from sympy import *

From here, execute some simple SymPy statements like the ones below:

>>> x = Symbol('x')
>>> limit(sin(x)/x, x, 0)
>>> integrate(1/x, x)

For a starter guide on using SymPy effectively, refer to the Tutorial.


If you have a question about installation or SymPy in general, feel free to visit the IRC channel at, channel #sympy. In addition, our mailing list is an excellent source of community support.

If you think there’s a bug or you would like to request a feature, please open an issue ticket.

Table Of Contents

Previous topic

Welcome to SymPy’s documentation!

Next topic


This Page