Skip to main content
NoteEDSL is in development. We recommend that you continually check for and install the latest version of EDSL to access the most recent features and bug fixes.

​
Prerequisites

Please ensure that Python is installed on your system before you install EDSL. You can download Python from the official website. You can use pip to install EDSL on your system (a package installer for Python).

​
Quickstart Installation

Check whether EDSL is already installed: 
pip show edsl
If installed, you will see the version number in the output. If not installed, run either of the following: 
pip install edsl
Or: 
! uv pip install edsl -q
Then get your API key from Expected Parrot and import dependencies: 
from edsl import login

login()
This will prompt you to log into your Expected Parrot account and automatically retrieve your API key. See the Managing Keys section for more details on managing your API keys for language models.

​
Installing from source

If you want to install EDSL from source, you can clone the repository from GitHub: 
pip install git+https://github.com/expectedparrot/edsl.git@main
This gives you the latest development changes ahead of PyPI releases.

​
Updating your version

To confirm that your version is up to date, compare your version number with the latest version on the EDSL PyPI page. To update your EDSL version to the latest one: 
pip install --upgrade edsl

​
Advanced installation

The steps above install EDSL globally. To avoid library conflicts, use a virtual environment. To create a virtual environment, open your terminal and run the following command: 
python -m venv myenv
This will create a folder called myenv. Next, activate your virtual environment: 
source myenv/bin/activate
You can now install EDSL through pip within your virtual environment: 
pip install edsl
Or: 
! uv pip install edsl -q
You will have access to EDSL while your virtual environment is activated. You can deactivate the virtual environment at any time by running: 
deactivate
To delete the virtual environment, simply delete the myenv folder.