Before You Start
This chapter assumes you are using a Windows computer. Every step is written for Windows. If you are on a Mac, the concepts are identical but a few of the installation steps are slightly different — the chapter notes will flag these where they occur.
You will need:
- A computer with internet access
- An email address you have access to right now
- About 90 to 120 minutes of uninterrupted time
- Permission to install software on your computer (administrator access)
You do not need:
- Any coding experience
- Any prior knowledge of GitHub, Python, or terminals
- A credit card for any of the tools in this chapter (everything here is free)
These are exactly the six tools that Team 1 used to build their market intelligence pipeline in TR2 2026. They are free, widely used in professional software development, and — critically — they are the same tools that your students will use. Going through this chapter means you will have personal experience with every tool you ask your students to work with.
Tool 1 — GitHub Account
GitHub is where your code lives. It is the platform where Team 1 made their 86 commits, managed their 26 branches, reviewed their 61 Pull Requests, and ran their three automated CI/CD workflows. Think of it as a combination of Google Drive (for storing files), a version history system (showing every change ever made), and an automation platform (running workflows automatically). Every team member contributes through GitHub. Every output is visible, timestamped, and attributed to a specific person.
What to Do — Step by Step
- Open your web browser and go to github.com
- Click the green "Sign up" button in the top right corner
- Enter your email address. Use a professional email — this account will be associated with your work as an educator
- Create a password. Make it strong — at least 12 characters with a mix of letters, numbers, and symbols
- Choose a username. This will be visible on everything you create. Professor Dr. Tan's username is
ProfDrTan— follow a similar professional format - Complete the verification puzzle GitHub shows you
- Click "Create account"
- GitHub will send a verification code to your email. Open your email, copy the 6-digit code, and enter it on the GitHub page
- GitHub will ask a few setup questions — answer them or click "Skip personalisation" at the bottom
Enable Two-Factor Authentication (Strongly Recommended)
- Click your profile picture (top right) → Settings
- In the left sidebar, click "Password and authentication"
- Scroll to "Two-factor authentication" and click "Enable"
- Follow the prompts to set up 2FA using an authenticator app (Google Authenticator or Microsoft Authenticator — both are free)
When you ask students to create GitHub accounts, their accounts are connected to their professional identity for life. LinkedIn integrates with GitHub. Employers look at GitHub profiles. The habits they form now — professional usernames, two-factor authentication, clear commit messages — follow them into their careers. Teach them right from the start.
Team 1 Connection
sinder38's GitHub account is the architectural foundation of everything Team 1 built. His very first commit — on 30 May 2026 — was Add basic gitignore. A simple one-file commit. By 21 June, the same account was managing 26 branches, 3 CI workflows, and an automated bot. Every sophisticated capability grew from that first commit. Your first commit will do the same.
Tool 2 — Git on Your Computer
GitHub is the website where your code is stored online. Git is the software on your computer that sends code to and from GitHub. Think of GitHub as a filing cabinet in the cloud and Git as the hands that put files in and take them out. Without Git on your computer, you cannot connect to GitHub from your machine. You will install it once and then barely think about it again — it works in the background.
What to Do — Windows
- Go to git-scm.com in your browser
- Click the large "Download for Windows" button. The download starts automatically
- Once downloaded, open the file (it will be named something like
Git-2.45.0-64-bit.exe) - The installer opens. Click "Next" on every screen — the default settings are correct. Do not change anything
- On the screen that says "Choosing the default editor used by Git", change the dropdown from Vim to "Use Visual Studio Code as Git's default editor" — you will install VS Code next, and this connects them
- Continue clicking "Next" and then "Install"
- When installation completes, click "Finish"
Connect Git to Your GitHub Account
After installation, you need to tell Git who you are. Press the Windows key, type cmd, and press Enter to open a Command Prompt (a black window with white text — do not be alarmed, this is normal). Then type each of these commands, pressing Enter after each one. Replace the details in quotes with your own name and email:
user.name=Prof Dr Tan and user.email=your.email@example.com
Tool 3 — VS Code (Your Code Editor)
VS Code is the application where you write and edit files. It is like Microsoft Word, but designed for code and text files rather than formatted documents. It understands the files you will be creating — Python scripts, YAML workflow files, Markdown documents — and shows them in colour-coded format that makes them easier to read and write. It is free, made by Microsoft, and used by professional developers worldwide. Team 1 used it as their primary editing environment.
What to Do
- Go to code.visualstudio.com
- Click the blue "Download for Windows" button
- Open the downloaded file and click through the installer. Accept the licence agreement and click "Next" on all screens
- On the "Select Additional Tasks" screen, tick "Add to PATH" and "Add 'Open with Code' action to Windows Explorer context menu" — both are useful
- Click "Install", then "Finish"
- VS Code will open automatically. You will see a welcome screen with a dark background
Install Two Essential Extensions
Extensions make VS Code smarter. You need two for this curriculum:
- In VS Code, click the square icon on the left sidebar (it looks like four squares, one separated) — this opens the Extensions panel
- In the search box, type Python. The first result should be "Python" by Microsoft. Click Install
- Search for GitHub Actions. The first result should be "GitHub Actions" by GitHub. Click Install
Team 1 Connection
Every file in Team 1's repository — from the simplest README.md to the complex run_pipeline.py — was written in a code editor like VS Code. When JasonEran built the delta engine on 20 June, making five commits in one day, each commit was a set of file changes saved from his editor and pushed to GitHub. The editor is where the thinking becomes code.
Tool 4 — Python
Python is the programming language that powers the market intelligence pipeline. It is the language Team 1 used for every automated script — the agents that collect and analyse data, the pipeline that sequences all the agents, the delta engine that scores predictions. Python is the most widely used language in data science, AI, and automation. It reads almost like plain English, which makes it approachable for educators who are not developers. You do not need to write Python from scratch in this curriculum — you need to understand what a Python script does and how to run one.
What to Do
- Go to python.org/downloads
- Click the large yellow "Download Python 3.12.x" button (the exact version number after 3.12 does not matter — just make sure it starts with 3.12 or higher)
- Open the downloaded file
- CRITICAL: On the first screen of the installer, there is a checkbox at the bottom that says "Add Python to PATH". Tick this box before clicking anything else. If you miss this step, Python will not work from the command line
- Click "Install Now" (the top option)
- Wait for installation to complete, then click "Close"
Verify Python Is Working
Open a new Command Prompt (press Windows key, type cmd, press Enter) and type:
Python 3.12.3 — a version number starting with 3.
Install the Three Packages You Will Need
Python packages are add-ons that give Python additional capabilities. Install the three packages this curriculum uses:
Type each line into the Command Prompt and press Enter. You will see text scrolling as each package installs. When it finishes and the cursor is back, move to the next command.
pip install command you see a line ending in Successfully installed yfinance-... (or whichever package you just installed).
yfinance is the package that Team 3 used when ZhangJiayu0201 built their first GitHub Actions workflow in seven minutes on 20 June 2026. The script fetch_friday_closes.py used yfinance to automatically download Friday's closing prices for SPX, NDX, and IWM from Yahoo Finance. Three lines of Python code replaced what had previously been a manual process of visiting a website, reading the numbers, and typing them into a file. This is the exact progression — from manual to automated — that this curriculum is designed to produce.
Tool 5 — OpenRouter API Account
OpenRouter is the service that allows a single Python script to call ChatGPT, Gemini, and DeepSeek simultaneously, without needing three separate API accounts. It acts as a bridge — you send one request to OpenRouter with the name of the AI model you want, and OpenRouter forwards it and returns the response. Team 1's LLM Operator (sun9226066/Charles) used OpenRouter to build the multi-model synthesis pipeline that became one of the most impressive components of their system. Setting up an OpenRouter account takes five minutes and costs nothing until you start making API calls — and for learning purposes, the costs are minimal (a few cents per test).
What to Do
- Go to openrouter.ai
- Click "Sign In" in the top right, then "Sign up"
- Create an account with your email address
- Once logged in, click your profile icon (top right) → "API Keys"
- Click "Create Key"
- Give it a name: ai-trading-lab
- Click "Create"
- The key appears — it starts with
sk-or-. Copy it immediately and save it somewhere safe (a password manager or a private note). You will not be able to see it again after closing this window
Add Credit to Your Account
- Click your profile icon → "Credits"
- Add USD $5 of credit — this is enough for many months of learning-level API usage
Store Your API Key Safely
Never put your API key directly in a code file. Instead, you will store it in a .env file — a special private file that Python reads but that GitHub keeps private. You will set this up in Chapter 5. For now, just keep your key copied somewhere safe.
Team 1 Connection
Team 1 stored their OpenRouter API key as a GitHub Actions secret — a value that is encrypted and only accessible to their workflow scripts. The key was referenced in code as os.environ["OPENROUTER_API_KEY"] — never written directly. When the Weekly Pipeline ran automatically, it retrieved the key from the secret vault, called OpenRouter, got responses from three LLMs, and saved the comparison to data/llm/llm_comparison_W24.md — all without any human intervention. You will do the same in Chapter 10.
Tool 6 — The Terminal (Your Command Centre)
The terminal — also called the command line, command prompt, or shell — is a text-based interface for controlling your computer. Instead of clicking icons, you type commands. It is less intuitive than clicking, but far more powerful for the kinds of tasks this curriculum involves: running Python scripts, sending code to GitHub, creating folders, and triggering automation. Every developer uses the terminal daily. By the end of this curriculum, you will be comfortable with the eight or ten commands that matter for this work, and that comfort will transfer directly to your ability to help students when they get stuck.
Open the Terminal
On Windows 11: Press Windows key + X, then click "Terminal".
On Windows 10: Press Windows key, type cmd, press Enter.
The Ten Commands You Need to Know
You do not need to memorise these now. Read through them once, then practise the ones marked with ★ before moving on.
★ Practise These Three Commands Right Now
- Open the terminal
- Type
cdand press Enter — note which folder you are in (probablyC:\Users\YourName) - Type
mkdir ai-trading-laband press Enter — you just created a folder - Type
cd ai-trading-laband press Enter — you are now inside that folder - Type
dirand press Enter — the folder is empty, which is expected - Type
cd ..and press Enter — you are back in the parent folder
ai-trading-lab folder using the terminal without error messages. The folder exists and you can see it in Windows Explorer.
Many educators feel intimidated by the terminal because it looks like hacking. It is not. It is just a different way of talking to your computer. Every GUI (graphical user interface) action — creating a folder, running a program, moving a file — has a terminal equivalent. The terminal is simply faster and more precise once you know the vocabulary. In this curriculum, you will use approximately eight commands repeatedly. After a week, they will feel as natural as clicking a button.
Final Verification — All Six Tools
Before moving to Chapter 5, run through this complete verification checklist. Open a terminal and type each command. Every one should produce a result, not an error.
In one afternoon, you have installed and verified six professional-grade tools — the same tools used by software engineers at companies around the world. You have a GitHub account, Git connected to it, a code editor, Python with the essential packages, an LLM API account, and working command-line skills. Team 1 started with these same tools. Chapter 5 is where you start building with them.