Windows
Download, double-click, and follow the terminal. Requires Python 3.10+.
Download install.bat01 Python v2 + PyHope App 1.1 “Sudbury”
A complete lightweight creative workspace. Sudbury now includes Home, Code Studio, safe managed Files, New Project, packaged Assets, Games/GPU, Connected Editors, Settings, and Docs tabs. It uses the Python standard library—not Electron, pygame, or a cloud account.
PYTHON V2 + PYHOPE1.1 SUDBURY⌂ Home>_ Code Studio▤ Files＋ New Project◆ Assets↗ Editors⚙ Settings
CREATIVE WORKSPACE
Code, files, assets, editors, websites, and games.
FILE SERVICECC0 ASSETSCONNECTED EDITORS
FIRST APP RELEASE
One installer. Your whole workspace.
- Edit, save, autosave, and run
.pyv2with Ctrl+Enter - Manage workspace files with safe paths and atomic saves
- Export eight original CC0 PyHope sprites offline
- Detect and open VS Code, VSCodium, Zed, Sublime, or PyCharm
- Create and preview complete Python v2 website projects
- Create validated Windows apps with JSON, safe data, dialogs, and EXE workflows
- Configure workspace, editor, font, and autosave settings
- Open the 10-game arcade and 9M GPU tools
- No pygame, Electron, cloud account, or paid dependency
Windows gets a Desktop shortcut. macOS gets
Python v2 Sudbury.app in ~/Applications.
Linux gets an application-menu entry.
02 One-click Python v2 + PyHope Installers
Install the language, Sudbury Launcher, and PyHope game engine together.
The scripts download the latest stable release, install the
pyv2, pyv2-launcher, and pyhope
commands, create the desktop app/shortcut, and run a self-check.
Readable source—no mystery executable.
macOS / Linux
Download, then run sh install.sh. Uses curl or wget.
Manual / portable
Download the source ZIP. No install is required to run from its folder.
Download ZIP
What gets installed?
pyv2 is the language; pyv2-launcher,
pyhope-studio, or pyhope --studio opens the
desktop workspace; and pyhope is our own dependency-free
game engine with vectors, sprites, tile maps, fixed-step
scenes, DDA ray casting, terminal preview, and web Canvas/WebGL renderers.
It does not install pygame.
Read the PyHope engine guide · Play the games · Get free CC0 sprites
03 Build Real Windows EXE Applications
Installed with the normal Python v2 installer. Sudbury Build Tools create console or windowed applications with command-line arguments, strict JSON, sandboxed persistent files, atomic saves, bundled read-only assets, and native message/input dialogs.
1. Create
pyv2 new windows-app "My App"
# add --windowed for a dialog app2. Validate
pyv2 check My-App
pyv2 doctor3. Build
pyv2 build My-App
# Windows:
pyv2 build My-App --nativeThe project includes a readable build-windows.bat,
PowerShell script, PyInstaller recipe, SHA-256 manifest, VS Code tasks,
and Windows GitHub Actions workflow. Native .exe creation
installs PyInstaller into a build environment on Windows; normal Python
v2 apps and the language runtime remain dependency-free. Other systems
produce the complete kit rather than a mislabeled binary.
Full app and
EXE guide →
04 Get the Language Manually
Pick your favorite flavor:
Git clone (recommended)
git clone https://github.com/gefrus112/pythonv2
cd pythonv2Updating later is one command: git pull.
Download ZIP
# then unzip it and open a terminal inside
cd pythonv2-mainEverything is plain text — the language, the website, the docs.
Download pythonv2-main.zipWhat's in the box
| Component | Where | What it is |
|---|---|---|
| Sudbury Workspace | pyv2/launcher.py | Home, editor, file service, projects, assets, games, connected editors, settings, and docs |
| Browser Playground | playground.html | Python v2 + Classic compatibility, commands, errors, and website workshop |
| Interpreter + CLI | pyv2/ | The language runtime: python3 -m pyv2 |
| PyHope engine | pyhope/ | Dependency-free sprites, scenes, tile maps and ray casting |
| 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/ | 112 tests: language + app/EXE builder + parity + PyHope + workspace + Playground + arcade |
05 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 1.1.0
# 4. run your first program
python3 -m pyv2 examples/hello.pyv2
# Hello, World!
# 2 + 2 = 4Windows
# 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!06 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. |
07 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 Games tab — monster four shooters, two platformers, two racers, Snake Byte, Orb Breaker, GPU lab, and animated free sprites.
- Subscribe to Cube Comet — the complete video install tutorial releases at 1,000 subscribers.
FAQ
| Question | Answer |
|---|---|
Is there a pip install? |
Yes—from the cloned folder: python3 -m pip install --user ..
The one-click scripts do this and create the app shortcut for you. |
| Can games use literally zero RAM? | No real app can. PyHope's 9M mode keeps ray work and the large framebuffer on the GPU, avoiding a 9-million-item Python list while still using normal system and GPU memory. |
| 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 . |