Installing Mathics

Here we describe the various ways to get Mathics installed.

Install from PyPI

Here is how you can install the full Mathics suites:

$ pip install Mathics-omnibus

This package doesn’t have any code in it. Instead it just contains dependencies to other PyPI Mathics packages.of other PyPI package. It is more or less equivalent to:


$ pip install Mathics3 # this is the core engine. It is a dependency of some of the below too $ pip install Mathics-Django # web front-end $ pip install mathicsscript # the command-line interface $ pip install pymathics-natlang # the Natural-language Python module $ pip install pymathics-graph # the Python module for working with Graphs and Networks

Note the name is “Mathics3” for the most recent release. “Mathics” has pre-Python 3 code.

See the previous sections for descriptions of the various pieces, what features they add and what dependencies are needed to run them.

Install from Conda-Forge


At present, the Conda Forge Mathics release is for an older version.

From docker (dockerhub)

As an alternative to building all the components from source or via Python package, you can run pre-built code for all of the components via docker. To download a copy of the docker image run:

$ docker pull mathicsorg/mathics

This will pull the latest development release that has a docker tagname #latest if you want a stable release, give the version in the pull command. For example

$ docker pull mathicsorg/mathics#2.0.0

From an OS-specific Repository

Click on the link below from for details for a specific OS and distribution:

Packaging status

Install from git from github

If you need the most recent fixes, you can install from github. Note that there isn’t a single github repository that contains everything.

Also, since Mathics is in constant flux, dependencies can change. The development version from might require development version from another.

These instructions then aren’t complete and may need to be adapted for the various Mathics3 github repositories


Mathics runs on Python 3.6 or later. We also support PyPy 3.6 or later.

Underneath, Mathics relies on sympy which relies on numpy. These and the other requirements will be installed automatically if you use the standard Python installer pip. They are also listed in

Several additional dependencies over what is described above if you want to:

  • build the documentation (which needs xetex, etc.)

  • do full testing (which needs pytest, etc.)

  • run the command-line interface

  • run the Django 3.1 webserver (which needs SQLite, etc.) `

Below we give command-line instructions for most of the core packages. We don’t include the numer

There is also GitHub’s git client for your operating system (Mac; Windows). For that, clone mathics/Mathics (there is a button at the top of that says “Clone in Mac” or “Clone in Windows” depending on your platform).

$ git clone
$ cd mathics-scanner
$ make install

$ cd ..
$ git clone
$ cd Mathics
$ make install

$ cd ..
$ git clone
$ cd mathics3-django
$ make install

$ cd ..
$ git clone
$ cd mathicsscript
$ make install

The above doesn’t include PyMathics modules, but each of those are installed in like fashion.

Alternatively use make develop or pip install -e to run the code installed from where the source-code is checked out. In doing this, code changes in the source tree are reflected immediately when you rerun.

Of course, you may not want this, but instead want to run from a copy of the last stable code, so that’s what make install does.

OS-dependent packages

For the installation above you may need OS-specific packages.

For Debian/Ubuntu based systems:

$ apt-get install python-dev libsqlite3-devp python-setuptools

as super-user, i.e. either after having issued su or by preceding the command with sudo).

On Mac OS X:

$ brew install sqlite3

On FreeBSD:

$ sudo pkg install math/py-mathics