Initial setup

Start by installing the latest version of Python. Open this link, click “Download Python,” and follow the installation instructions.

Once the installation finishes, you will see a Finder window showing what was installed. (If you closed the window, open Finder, click on “Applications,” and then “Python 3.10” (or whatever version of Python you just installed).

Double-click on “Install Certificates.command” and then “Update Shell Profile.command”. Each of these will open a Terimal window and run a bunch of commands. Once you see [Process completed], you may close the window.

👾 💬

If you see a red “Permission denied” error message when running “Install Certificates.command”, open a Terminal window and run sudo "/Applications/Python 3.10/Install Certificates.command" instead. You will be asked for an administrator password; you won’t see any letters appearing as you enter the password. This is a security feature.

💻 Check system requirements

1. Go to Settings > System > About.
2. Check that the Edition is Windows 10.
3. Check that System type says “64-bit operating system…”

(based on this guide)

💻 Ubuntu

Follow along with this video until the ‘6:15’ mark, or follow the steps below. Once you have Ubunutu installed, skip below to “Download VcXsrv for graphics”.

Enable developer tools

1. Go to Control Panel > Programs > Program Features > Turn Windows Features On Or Off.
2. Enable the “Windows Subsystem for Linux” option in the list, and then click the “OK” button.
3. Click “Restart now” when you’re prompted to restart your computer.

Download Ubuntu

1. After your computer restarts, open the Microsoft Store from the Start menu, and search for “Ubunutu” in the store.
2. Click Get to install “Ubuntu”.

(Based on this guide)

Setup Ubuntu

1. Open Ubuntu, it will take a few minutes to install updates.
2. As prompted, create a username and password.
3. Give your user admin privileges by typing usermad -aG sudo your-name and pressing enter (again, replace your-name).
4. Run the following commands:

sudo apt update && upgrade
sudo apt install python3 python3-pip

💻Download VcXsrv for graphics

1. Download VcXsrv from this link by clicking Download App.
2. Install the package that downloads by double clicking on it and going through the install wizard.

💻Download Atom

1. Download Atom from this website and install.

(This guide has instructions for installing shell commands to open files and projects in Atom)

👾 💬

Whenever this website says to use Terminal, you should use Ubuntu. There will be other small differences for Windows users that we’ll explain along the way.