Installing erdpy

How to install erdpy

erdpy is currently supported on Linux and MacOS. Some of its features might work on Windows as well, although using erdpy on Windows is neither recommended, nor supported at this time.

Prerequisites

Before installing erdpy, please make sure you have a working Python 3 (3.6 or later on Linux, 3.8 or later on MacOS) environment.

In order to install erdpy using the erdpy-up installation script, run the following commands in a terminal:

wget -O erdpy-up.py https://raw.githubusercontent.com/ElrondNetwork/elrond-sdk/master/erdpy-up.py
python3 erdpy-up.py

This will create a light Python virtual environment (based on venv) in ~/elrondsdk/erdpy-venv and also include ~/elrondsdkin your $PATH variable (by editing the appropriate .profile file).

Install without erdpy-up

If you'd like to install without relying on the easy installation script, please read this section. Otherwise, feel free to skip it.

Make sure you also have pip3 installed.

Prepare PATH

In order to have the command erdpy available in your shell after install, make sure you adjust the PATH environment variable as described below:

On Linux in ~/.profile:

export PATH="$HOME/.local/bin:$PATH"

On MacOS in ~/.bash_profile or ~/.zshrc if you’re using zsh:

export PATH=$HOME/Library/Python/3.8/bin:${PATH}

In the snippet above, replace 3.8 with your actual MAJOR.MINOR version of Python. This can be found by running:

python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"

You may need to restart your user session for this changes to take effect.

Install and smoke test

In order to install erdpy, issue the following command:

pip3 install --user --upgrade --no-cache-dir erdpy

Troubleshooting

If you encounter encoding-related issues at installation time, such as: UnicodeDecodeError: 'ascii' codec can't decode byte, then please set PYTHONIOENCODING before running the install command:

PYTHONIOENCODING=utf8 pip3 install --user --upgrade --no-cache-dir erdpy