Installation on Windows¶
To develop with the Arcade library, we need to install Python, then install Arcade, and finally install a development environment.
Step 1: Install Python¶
Install Python from the official Python website:
As of Mar-30-2020, it is easiest to get Arcade working with Python 3.7.x. Arcade uses two other libraries “Numpy” and “Pillow” which are difficult to install on Python 3.8.x, particularly under PyCharm. If you wish to use Python 3.8, see additional instructions in the note at the end of this page.
When installing Python, make sure to customize the installation and add Python to the path:
The defaults on the next screen are fine:
Then install Python for all users:
A video of the installation is below:
Step 2: Install The Arcade Library¶
If you install Arcade as a pre-built library, there are two options on how to do it. The best way is to use a “virtual environment.” This is a collection of Python libraries that only apply to your particular project. You don’t have to worry about libraries for other projects conflicting with your project. You also don’t need “administrator” level privileges to install libraries.
Install Arcade with PyCharm and a Virtual Environment¶
If you are using PyCharm, setting up a virtual environment is easy. Once you’ve got your project, open up the settings:
Select project interpreter:
Create a new virtual environment. Make sure the venv is inside your project folder.
Now you can install libraries. PyCharm will automatically ask to add them if you have a file called requirements.txt that lists the required libraries.
If you are using Python 3.8, the “Numpy” and “Pillow” libraries might try to build themselves from scratch, which will probably error out. To fix, we can manually update “pip” by opening a a PyCharm terminal, and then typing the following into the terminal:
python -m pip install -U --force-reinstall pip
Restart PyCharm (or exit and restart the terminal) and then attempt to install Arcade again.
Install Arcade using the command line interface¶
If you prefer to use the command line interface (CLI), then you can install arcade directly using pip:
pip3 install arcade
If you happen to be using pipenv, then the appropriate command is:
python3 -m pipenv install arcade