Ubuntu Installation Instructions

Warning

If you want to install the bleeding-edge or development version of Aesara from GitHub, please make sure you are reading the latest version of this page.

Requirements

Note

We only support the installation of the requirements through conda.

Python == >= 3.7
The development package (python-dev or python-devel on most Linux distributions) is recommended (see just below). Python 2.4 was supported up to and including the release 0.6. Python 2.6 was supported up to and including the release 0.8.2. Python 3.3 was supported up to and including release 0.9. Python 3.6 was supported up to and including release 2.3.4.
NumPy >= 1.9.1
Earlier versions could work, but we don’t test it.
SciPy >= 0.14
Only currently required for sparse matrix and special functions support, but highly recommended. SciPy >=0.8 could work, but earlier versions have known bugs with sparse matrices.
BLAS installation (with Level 3 functionality)
  • Recommended: MKL, which is free through Conda with mkl-service package.
  • Alternatively, we suggest to install OpenBLAS, with the development headers (-dev, -devel, depending on your Linux distribution).

Optional requirements

python-dev, g++ >= 4.2
Highly recommended. Aesara can fall back on a NumPy-based Python execution model, but a C compiler allows for vastly faster execution.
Sphinx >= 0.5.1, pygments
For building the documentation. LaTeX and dvipng are also necessary for math to show up as images.
pydot-ng
To handle large picture for gif/images.
warp-ctc
Required for Aesara CTC implementation. It is faster then using an equivalent graph of Aesara ops.

Installation

Stable Installation

With conda

If you use conda, you can directly install aesara. .. code-block:: bash

conda install aesara

With pip

aesara

Install the latest stable version of Aesara with:

<sudo> pip install <--user> Aesara[test, doc]
  • Any argument between <…> is optional.
  • Use sudo for a root installation.
  • Use user for a user installation without admin rights. It will install Aesara in your local site-packages.
  • Use pip install -r requirements.txt to install the requirements for testing.
  • Use pip install -r requirements-rtd.txt install the requirements for generating the documentation.

If you encountered any trouble, head to the Troubleshooting page.

Developer Installation

Install the developer version of Aesara with:

git clone git://github.com/aesara-devs/aesara.git
cd aesara
<sudo> pip install <--user> <--no-deps> -e .
  • Any argument between <…> is optional.
  • Use sudo for a root installation.
  • Use user for a user installation without admin rights. It will install Aesara in your local site-packages.
  • Use no-deps when you don’t want the dependencies of Aesara to be installed through pip. This is important when they have already been installed as system packages.
  • -e makes your installation editable, i.e., it links it to your source directory.

If you encountered any trouble, head to the Troubleshooting page.

Manual Openblas installation (deprecated)

The openblas included in some older Ubuntu version is limited to 2 threads. Ubuntu 14.04 do not have this limit. If you want to use more cores at the same time, you will need to compile it yourself. Here is some code that will help you.

# remove openblas if you installed it
sudo apt-get remove libopenblas-base
# Download the development version of OpenBLAS
git clone git://github.com/xianyi/OpenBLAS
cd OpenBLAS
make FC=gfortran
sudo make PREFIX=/usr/local/ install
# Tell Aesara to use OpenBLAS.
# This works only for the current user.
# Each Aesara user on that computer should run that line.
echo -e "\n[blas]\nldflags = -lopenblas\n" >> ~/.aesararc