Installation

Pyomo currently supports the following versions of Python:

  • CPython: 3.10, 3.11, 3.12, 3.13, 3.14

  • PyPy: 3

At the time of the first Pyomo release after the end-of-life of a minor Python version, Pyomo will remove testing for that Python version.

Using CONDA

We recommend installation with conda, which is included with the Anaconda distribution of Python. You can install Pyomo in your system Python installation by executing the following in a shell:

conda install -c conda-forge pyomo

Optimization solvers are not installed with Pyomo, but some open source optimization solvers can be installed with conda as well:

conda install -c conda-forge ipopt glpk

Using PIP

The standard utility for installing Python packages is pip. You can install Pyomo in your system Python installation by executing the following in a shell:

pip install pyomo

Optional Dependencies

Extensions to Pyomo, and many of the contributions in pyomo.contrib, often depend on additional third-party Python packages including but not limited to: matplotlib, networkx, numpy, openpyxl, pandas, pint, scipy, sympy, and xlrd.

A full list of optional dependencies can be found in Pyomo’s setup.py. They can be displayed by running:

# Legacy format
python setup.py dependencies --extra optional
# Newer format - prints as a JSON
python -m pip install --dry-run --report - '.[optional]'

Pyomo extensions that require any of these packages will generate an error message for missing dependencies upon use.

When using pip, all optional dependencies can be installed at once using the following command:

pip install 'pyomo[optional]'

When using conda, many of the optional dependencies are included with the standard Anaconda installation.

You can check which Python packages you have installed using the command conda list or pip list. Additional Python packages may be installed as needed.

Installation with Cython

Users can opt to install Pyomo with cython initialized.

Note

This can only be done via pip or from source.

Installation via pip or from source is done the same way - using environment variables. On Linux/MacOS:

export PYOMO_SETUP_ARGS=--with-cython
pip install pyomo

On Windows:

# Via command prompt
set PYOMO_SETUP_ARGS=--with-cython
# Via powershell
$env:PYOMO_SETUP_ARGS="--with-cython"
pip install pyomo

From source (recommended for advanced users only):

export PYOMO_SETUP_ARGS=--with-cython
git clone https://github.com/Pyomo/pyomo.git
cd pyomo
# Use -e to install in editable mode
pip install .