Skip to main content

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

  1. Download PISTON-0.1.0-alpha-win64.exe
  2. Run it. It shows the end-user licence, which you must accept to continue.
  3. It installs to C:\Program Files\PISTON and adds a Start-menu shortcut to the GUI
  4. Remove it later from Windows' installed-apps list; an uninstaller is included

Portable ZIP

  1. Download PISTON-0.1.0-alpha-win64.zip
  2. Unzip it anywhere. Nothing is installed.
  3. Run bin\piston-gui.exe for the GUI or bin\piston.exe for 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 SHA256

The printed hash must equal the one here:

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 --help

Documentation in the download

  • docs\user_guide\quickstart.md: the full first-run walkthrough
  • docs\validation\accuracy.generated.md: measured accuracy against published figures, generated by the release build
  • docs\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.