Instructions on how to install Python and JES for the following platforms

• Windows
• macOS (x86, Intel based)
• macOS (ARM, Apple Silicon based)

For Linux installations use:

• x86 Linux, follow macOS (x86) instructions.
• ARM Linux, follow macOS (ARM) instructions.

Windows

1. Install VS Code
   • Download the installer
   • Open the installer.
   • follow the instructions and accept the default settings.
2. Python 3.9.10 Installation
   • Download the Windows 64-bit python-3.9.10-amd64.exe installer
   • Start the installer and select Add Python 3.9 to PATH
   • Follow any recommendations suggested by the installator ex. "Disable path length limit"
   • Click Customize Installation
     
     
     
   • Selecting next to accept the default settings.
   • Select the first check box Install for all users.
   • Restart the computer
3. Install JES4py
   • Open VS Code
   • Open a new terminal within VS Code
     
     
   
   
   • Type "python -m pip install -U jes4py" and press "enter"
     
     
     
   • You will get an error during installation if you don't have VS build tools with C++ 14.0 or later.
     
     If you do get this error:
     • Download MS C++ Build Tools.
     • Select Download Build Tools.
     • Run the executable and follow the promps until are prompted to install packages.
     • Select the check box for Desktop development with C++.
     • Select next and wait for the packages to download and install. This may take a while.
     • Restart your computer.

macOS
First, we need to check if your mac is either Intel or Apple Silicon based.
To do that click the Apple Logo at the top left corner and select "About this Mac".


Apple Silicon mac will have information similar to what is in the screenshot below:


Intel based mac will have information similar to what is in the screenshot below:

macOS (x86, Intel based)

1. Visual Code installation:
   • Download the installer
   • Open the installer and follow its instructions leaving default settings
2. Python installation:
   • Download Python 3.9.10 macos11.pkg installer
   • Run it and follow the installator's instructions
3. Install JES4py
   • Open VS Code
   • Open a new terminal within VS Code
     
     
     
   • Type "python3 -m pip install -U jes4py" and press "return"
     
     
     
   • Wait until it is done

macOS (ARM, Apple Silicon Based)

1. Visual Code installation:
   • Download the installer
   • Open the installer and follow its instructions leaving default settings
2. Python installation:
   • Download Python 3.9.10 macos11.pkg installer
   • Run it and follow the installator's instructions
3. Install JES4py
   • Open VS Code
   • Open a new terminal within VS Code
   • Type " /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/AleksandrMolchagin/cs107-ta/main/macOS_arm.sh)" " and press "return"
   • If the terminal asks you for your password, enter it and press "return" (note: you won't be able to see your password (or stars) while entering it)
   • Press "return" to continue
     
     
     
   • Wait until it is done