After downloading your AMPL & Solvers bundle from the AMPL Portal, please follow the instructions below that correspond to your operating system.
How to install using amplpy:
# Install Python API for AMPL
$ python -m pip install amplpy --upgrade
# Install solver modules (e.g., HiGHS, CBC, Gurobi)
$ python -m amplpy.modules install highs cbc gurobi --upgrade
# Activate your license (e.g., free https://ampl.com/ce license)
$ python -m amplpy.modules activate <license-uuid>
# Import in Python
$ python
>>> from amplpy import AMPL
>>> ampl = AMPL() # instantiate AMPL objectWe recommend using Visual Studio Code with the official AMPL VS Code plugin for the best experience:
Full syntax highlighting and model navigation
Easy access to solver output
Integrated license and data management
👉 You can install the AMPL plugin directly from the VS Code Marketplace.
Use VS Code’s editor and the official AMPL extension to write, run, and debug models all in one environment.
How to use:
AMPL Model Colaboratory is a collection of AMPL models in Jupyter Notebooks that run on platforms such as Google Colab, Kaggle, Gradient, and AWS SageMaker.
Setting up your notebook:
In order to use AMPL on notebook platforms you just need to add the following two code blocks at the beginning of your notebook:
# Install dependencies
%pip install -q amplpy# Google Colab & Kaggle integration
from amplpy import AMPL, ampl_notebook
ampl = ampl_notebook(
modules=["gurobi", "cbc", "highs"], # modules to install
license_uuid="default") # license to useAMPL APIs are interfaces that allow developers to access the features of the AMPL interpreter from within a programming language. We have APIs available for:
Download the Windows installer from the AMPL License Portal website.
Run the installer.
When prompted, enter your License UUID (e.g., for AMPL Community Edition or AMPL for Courses).
If you provide it during installation, your license will be automatically activated.
Tip: We recommend installing AMPL in your home folder (e.g., C:\Users\<YourName>\AMPL) to avoid permission issues.
If using dynamic cloud licenses, do not install in C:\Program Files\AMPL — that folder is read-only and won’t work with dynamic licensing.
If you’ve already installed AMPL but didn’t enter your license during installation, you can activate it manually:
Open AMPL.
Run the following command inside the AMPL console:
ampl: shell "amplkey activate --uuid <license-uuid>";
3. Close and restart AMPL to apply the license.
We recommend using Visual Studio Code with the official AMPL VS Code plugin for the best experience:
Full syntax highlighting and model navigation
Easy access to solver output
Integrated license and data management
👉 You can install the AMPL plugin directly from the VS Code Marketplace.
Download the macOS installer from the AMPL License Portal website.
Run the installer and follow the on-screen instructions.
At the end of the installation process, you will be prompted to enter your License UUID (e.g., for AMPL Community Edition or AMPL for Courses).
If you provide it during installation, your license will be automatically activated.
If you’ve already installed AMPL but didn’t enter your license during installation, you can activate it manually:
Open AMPL (e.g., from Terminal or the AMPL application).
Run the following command inside the AMPL console:
ampl: shell "amplkey activate --uuid <license-uuid>";
* Replace <license-uuid> with the actual license code you received.
3. Close and restart AMPL to apply the license.
We recommend using Visual Studio Code with the official AMPL VS Code plugin for the best experience:
Full syntax highlighting and model navigation
Easy access to solver output
Integrated license and data management
👉 You can install the AMPL plugin directly from the VS Code Marketplace.
Download and extract your bundle above. This will be your AMPL directory. Rename it if you like, and move it anywhere on your computer that you want.
Warning: Please make sure you place AMPL in a directory where you have write permissions such as your home directory. Otherwise, please see the note at the end.
Open VS Code, install the AMPL plugin. If AMPL is not on the system path, configure the path to the AMPL binary in the settings.
In a command window, use cd to go to your AMPL directory, then type ./ampl at the system prompt. Then you will see an ampl: prompt and can proceed to type AMPL commands.
Run this command in AMPL to activate your license:
ampl: shell "amplkey activate --uuid <license-uuid>";
# replace <license-uuid> by the license UUID
Note: you need to restart AMPL in order to start using the new license.
If you install AMPL somewhere in your home directory, you do not need to worry about the following.
If you use cloud licenses (e.g., AMPL Community Edition licenses), the AMPL directory cannot be read-only. If really you want to have AMPL installed on a read-only directory, you need to set the environment variables AMPL_LICFILE to a location where you store ampl.lic and where you have permissions to write, and set AMPLKEY_RUNTIME_DIR to a temporary directory.
For instance, assuming that you want to install AMPL on a Linux system in the /opt directory, which is not writeable by normal users. To install AMPL and dynamic licenses, you need to do the following:
Unpack the AMPL tarball into /opt as root user. The executables should then be at /opt/ampl.linux-intel64/.
For each user that wants to use this AMPL installation with his own license:
Define environment variables to point to a writeable directory in the user home directory:
export AMPL_LICFILE=$HOME/.ampl/ampl.lic
export AMPLKEY_RUNTIME_DIR=$HOME/.ampl
export PATH=/opt/ampl.linux-intel64/:$PATH
and add those definitions to the .bash_profile or .bashrc of each user.
2. Start a new terminal in order to load the new environment variable definitions.
3. Run the amplkey activate --uuid <license-uuid> command in the terminal.
AMPL and all solvers are available as python packages for Windows, Linux (X86_64, aarch64, ppc64le), and macOS.
# Install Python API for AMPL
$ python -m pip install amplpy --upgrade
# Install solver modules (e.g., HiGHS, CBC, Gurobi)
$ python -m amplpy.modules install highs cbc gurobi
# Activate your license (e.g., free https://ampl.com/ce license)
$ python -m amplpy.modules activate <license-uuid>
# Import AMPL into the Python
$ python
>>> from amplpy import AMPL
>>> ampl = AMPL() # instantiate AMPL object
Enhance your AMPL workflow with VS Code’s powerful editor and the official AMPL extension, enabling you to write, run, and debug models seamlessly in one environment.
# Google Colab & Kaggle integration
from amplpy import AMPL, ampl_notebook
ampl = ampl_notebook(
modules=["gurobi", "cbc", "highs"], # modules to install
license_uuid="default") # license to use
!pip install amplpy #Install dependenciesAMPL Model Colaboratory is a collection of AMPL models in Jupyter Notebooks that run on platforms such as Google Colab, Kaggle, Gradient, and AWS SageMaker. In order to be use AMPL on these notebook platforms you just need to following two code blocks at the beginning of your notebook:
# Install dependencies
%pip install -q amplpy
# Google Colab & Kaggle integration
from amplpy import AMPL, ampl_notebook
ampl = ampl_notebook(
modules=["gurobi", "cbc", "highs"], # modules to install
license_uuid="default") # license to use
Place ampl.mswin64 in a folder where you have write permissions without requiring Administrator access.
amplide folder in your AMPL directory and double-click amplide.exe.sw.exe icon and type ampl at the prompt in the window that appears. Then you will see an ampl: prompt and can proceed to type AMPL commands.Note: you need to restart AMPL in order to start using the new license.
ampl: shell "amplkey activate --uuid <license-uuid>";
# replace <license-uuid> by the license UUID
It is recommended to install AMPL in your home folder. Otherwise, if you use dynamic cloud licenses, make sure the AMPL folder is not read-only (e.g., it will not work if installed at "C:\Program Files\AMPL").
You will need to tell macOS that your AMPL software is safe to run.
Double-click your AMPL folder to open it and then follow these steps:
ampl: in the last line in the window. You can now close the window. “Amplide” is damaged and can’t be opened. You need to run ampl.command to tell macOS that your AMPL software is safe to run.
ampl. You should see an ampl: prompt appear and can now proceed to enter AMPL commands.For macOS, we have an installer available that asks for the license UUID at the end for the installation process.
In case you have AMPL already installed, activate your license if you received a license UUID (e.g., AMPL CE or AMPL for Courses licenses):
Run this command in AMPL to activate your license:
ampl: shell "amplkey activate --uuid <license-uuid>";
# replace <license-uuid> by the license UUID
Note: you need to restart AMPL in order to start using the new license.
If you install AMPL somewhere in your home directory, you do not need to worry about the following.
If you use cloud licenses (e.g., AMPL Community Edition licenses), the AMPL directory cannot be read-only. If really you want to have AMPL installed on a read-only directory, you need to set the environment variables AMPL_LICFILE to a location where you store ampl.lic and where you have permissions to write, and set AMPLKEY_RUNTIME_DIR to a temporary directory.
ampl: shell "amplkey activate --uuid <license-uuid>";
# replace <license-uuid> by the license UUID
Note: you need to restart AMPL in order to start using the new license.
If you install AMPL somewhere in your home directory, you do not need to worry about the following.
If you use cloud licenses (e.g., AMPL Community Edition licenses), the AMPL directory cannot be read-only. If you really want to have AMPL installed on a read-only directory, you need to set the environment variables:
AMPL_LICFILE to a location where you store ampl.lic and where you have permissions to writeAMPLKEY_RUNTIME_DIR to a temporary directoryFor instance, assuming that you want to install AMPL on a Linux system in the /opt directory, which is not writeable by normal users. To install AMPL and dynamic licenses, you need to do the following:
/opt as root user. The executables should then be at /opt/ampl.linux-intel64/.export AMPL_LICFILE=$HOME/.ampl/ampl.lic
export AMPLKEY_RUNTIME_DIR=$HOME/.ampl
export PATH=/opt/ampl.linux-intel64/:$PATH.bash_profile or .bashrc of each user.
amplkey_activate --uuid <license-uuid> command in the terminal.Place AMPL in a directory where you have write permissions such as your home directory. Otherwise, please see the note at the end.
amplide and run the amplide executable.cd to go to your AMPL directory, then type ./ampl at the system prompt. Then you will see an ampl: prompt and can proceed to type AMPL commands.