DOWNLOAD PISTON
Free for personal and commercial use under the end-user licence included in the download (EULA.md). PISTON is an alpha: expect rough edges.
Version 0.1.0-alpha • Released 2026-09-23 • 64-bit Windows only • Verify your download
There are no macOS or Linux builds.
SYSTEM REQUIREMENTS
Requirements
What the release build needs to run
- OS: 64-bit Windows
- CPU: x86-64 with SSE4.2 and POPCNT (the x86-64-v2 baseline; most CPUs from about 2009 on)
- Graphics: OpenGL 3.3 for the GUI. The command-line tool needs no GPU.
- Storage: about 20 MB installed
INSTALLATION
Installer
- Download
PISTON-0.1.0-alpha-win64.exe - Run it. It shows the end-user licence, which you must accept to continue.
- It installs to
C:\Program Files\PISTONand adds a Start-menu shortcut to the GUI - Remove it later from Windows' installed-apps list; an uninstaller is included
Portable ZIP
- Download
PISTON-0.1.0-alpha-win64.zip - Unzip it anywhere. Nothing is installed.
- Run
bin\piston-gui.exefor the GUI orbin\piston.exefor the command line
Both packages contain the same thing: the GUI and the command-line tool, the runtime DLLs, the engine configs and examples, a seeded parts database, and the documentation.
THE BINARIES ARE UNSIGNED
PISTON has no code-signing certificate yet, so Windows SmartScreen may warn when you first run the installer or an executable. If you choose to proceed, click "More info" → "Run anyway". Check the SHA-256 checksum below first: it is the substitute for a signature.
In PowerShell, in the folder you downloaded to:
Get-FileHash .\PISTON-0.1.0-alpha-win64.exe -Algorithm SHA256
Get-FileHash .\PISTON-0.1.0-alpha-win64.zip -Algorithm SHA256The printed hash must equal the one here:
PISTON-0.1.0-alpha-win64.exe
d779caa13d3a158777d4f1e04b2711ea311d83453e380724e562359a4e8f6dba
PISTON-0.1.0-alpha-win64.zip
7bfda6d91cf9d6da4fefe1ff437dac3a4518478c48d164710fafbd6f77eaa784
YOUR FIRST SIMULATION
1In the GUI
Start PISTON from the Start menu (or bin\piston-gui.exe), open one of the bundled engines and run a dyno pull.
2From the command line
Open PowerShell in the PISTON folder (the unzipped folder, or C:\Program Files\PISTON) and write results to your home folder:
# Check a config, then sweep it and write the curve to CSV
bin\piston.exe validate -c data\engines\ford_coyote_50.json
bin\piston.exe simulate -c data\engines\ford_coyote_50.json -o $HOME\coyote.csv
# A self-contained HTML report: spec, curve, peaks
bin\piston.exe report -c data\engines\ford_coyote_50.json -o $HOME\coyote.html
# Every command
bin\piston.exe --helpDocumentation in the download
docs\user_guide\quickstart.md: the full first-run walkthroughdocs\validation\accuracy.generated.md: measured accuracy against published figures, generated by the release builddocs\physics\limitations.md: where the model is known to be weaker, by engine class
HELP
The GUI won't start
- It needs OpenGL 3.3: update your graphics driver. Remote-desktop sessions and some virtual machines don't provide it.
- The command-line tool,
bin\piston.exe, works without a GPU.
A results file can't be written
- Program Files is not writable without administrator rights: write to your home folder, as in the examples above
- Close the file if another program (such as Excel) has it open
Still stuck?
Email [email protected] with the version (bin\piston.exe version), what you ran, and what happened.