Skip to content

Latest commit

 

History

History
47 lines (37 loc) · 1.83 KB

setup.md

File metadata and controls

47 lines (37 loc) · 1.83 KB
Raw

System requirements and setup

In all cases, open a browser to visit https://github.com/adetaylor/browser-learning

  • you should be looking at these pages!

Mac

  1. Open Terminal.
  2. Run python3 --version. See what Python version you have. You need at least Python 3.12. You can get it from the main Python website.
  3. Fetch and install Visual Studio Code if you don't already have it.
  4. Fetch the zip of this course (your instructor will tell you how).
  5. In Terminal, run:
git clone https://github.com/adetaylor/browser-learning.git
cd browser-learning
python3 -m venv venv
. venv/bin/activate
python3 -m pip install -r src/requirements.txt

Chromebooks

  1. Under the main menu in bottom left corner of the screen, open Terminal. Follow the instructions to turn on the Linux environment if necessary. Go with all the standard settings. (Note that this environment may not be available for guest users)
  2. In the terminal, run these commands:
git clone https://github.com/adetaylor/browser-learning.git
cd browser-learning
./install-chromebook-prerequisites.sh
python3 -m venv venv
. venv/bin/activate
pip3 install -r src/requirements.txt
  1. Keep the terminal open - you'll need it to run commands. (If you open a new terminal, run cd browser-learning and then . venv/bin/activate)
  2. From the main menu, also open Visual Studio code.

Other types of machine

Do what's required to install:

  • Python 3.12+
  • tcpdump
  • Visual Studio code, or some other good code editor (the students will be doing lots of reading code so a good IDE is highly recommended)

Troubleshooting

  • I see "If this fails your Python may not be configured for Tk". This is probably on MacOS and you probably installed python using brew; brew install python-tk might work.