Downloads — Python v2

01 Get the Language

Pick your favorite flavor:

Git clone (recommended)

git clone https://github.com/gefrus112/pythonv2
cd pythonv2

Updating later is one command: git pull.

Open the GitHub repo

Download ZIP

# then unzip it and open a terminal inside
cd pythonv2-main

Everything is plain text — the language, the website, the docs.

Download pythonv2-main.zip

What's in the box

Component	Where	What it is
Interpreter + CLI	`pyv2/`	The language runtime: `python3 -m pyv2`
Browser runtime	`pyv2.js`	The same language in JavaScript (this website's playground)
Examples	`examples/`	hello, fib, fizzbuzz, terminal_raycast
VS Code extension	`editors/vscode/`	Syntax highlighting + snippets
Dev container	`.devcontainer/`	Ready environment for VS Code / Codespaces
Tests	`tests/`	64 tests incl. cross-runtime parity

02 Install on Your Machine

One requirement: Python 3.10 or newer (python.org/downloads). Python v2 itself has zero dependencies.

macOS & Linux

# 1. check your Python (macOS ships python3; Linux: apt/dnf install python3)
python3 --version        # need 3.10+

# 2. get the language
git clone https://github.com/gefrus112/pythonv2
cd pythonv2

# 3. verify the install
python3 -m pyv2 --version
# Python v2 0.2.0

# 4. run your first program
python3 -m pyv2 examples/hello.pyv2
# Hello, World!
# 2 + 2 = 4

Windows

# Option A — plain PowerShell / cmd
py --version             # install from python.org if missing
git clone https://github.com/gefrus112/pythonv2
cd pythonv2
py -m pyv2 examples/hello.pyv2

# Option B — WSL (recommended): install Ubuntu from the
# Microsoft Store, then follow the macOS & Linux steps.

Make it your own

Add a shell alias so you can just type pyv2:

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
alias pyv2='python3 -m pyv2'

# now:
pyv2 examples/fib.pyv2
pyv2                      # REPL!

03 Install in Your Editor

Full step-by-step guides live in the documentation. The quick tour:

Editor	Setup
VS Code	Open the repo folder → press `Ctrl`+`Shift`+`B` to run the current file. Copy `editors/vscode` into `~/.vscode/extensions` for highlighting. Full guide →
Dev Containers / Codespaces	Dev Containers: Reopen in Container — or create a codespace on GitHub. Everything preinstalled. Full guide →
Sublime / Vim / JetBrains / Notepad++	Any editor that can run a shell command works — recipe included for each. Full guide →
Just a terminal	`python3 -m pyv2 file.pyv2` — that's the whole install.

04 Learn the Language

Installed? Nice. Next stop:

The tutorial — 10 short lessons, every example runnable right here in your browser.
The documentation — language reference, editor setup, and a try-it sandbox.
The CPU raycaster — proof that Python v2 people have too much fun.

FAQ

Question	Answer
Is there a `pip install`?	Not yet — clone and run. There is literally nothing else to install.
Does it replace my Python?	Nope. Python v2 lives in its own folder and runs on top of Python 3. Nothing to uninstall, nothing breaks.
Which platforms?	Anything with Python 3.10+: macOS, Linux, Windows, WSL, Raspberry Pi, dev containers, Codespaces.
How do I update?	`git pull` — then run the tests if you're curious: `python3 -m unittest discover -s tests -t .`

Downloads & Installation