Downloads

Install Lispex

Download the Native executable for your operating system, or install it with one command.

Download file version v1.21.3

Install with one command

# macOS / Linux
curl -fsSL https://www.lispex.com/install.sh | sh

# Windows (PowerShell)
irm https://www.lispex.com/install.ps1 | iex

The install script finds the latest release when it runs and compares the downloaded executable with the SHA-256 checksum file published beside it.

Check the version

Open a new terminal and run this command. Native prints its name and version.

lispex --version

lispex 1.21.3

If the command is not found

• macOS and Linux install to ~/.lispex/bin by default. Add that directory to PATH, then restart the shell.
• Windows installs to %LOCALAPPDATA%\Lispex\bin by default. Add that directory to the user PATH, then open a new PowerShell window.

Install in a project with npm

With Node 18 or newer, install the npm package in your project folder.

npm install lispex

Check the version with npx in the same folder. npx runs the lispex command installed in that folder. The npm package prints only the version number.

npx lispex --version

1.21.3

Save this program as hello.lspx in the same folder.

(define language "Lispex")

(list 'hello language (+ 2 3))

Run the file with npx. The command prints this result, exits with status 0, and creates no files.

npx lispex hello.lspx

(hello "Lispex" 5)

To use the lispex command in any folder, you can also install the package globally. If Native is also installed, the lispex command runs the product whose directory comes first on PATH.

npm install -g lispex

If the command is not found, confirm that Node 18 or newer is active and that the global npm binary directory is on PATH.

Use Lispex without installing

The Playground runs Lispex in your browser with nothing to install. First Program starts in the Playground, so you can follow it before you install.

Other distributions

Choose where to run

All three use the Lispex Interpreter by default. In a terminal, a successful run prints its result, exits with status 0, and creates no files. The product is what you install or open. The execution method is how that product runs the program.

• Choose Native for the widest set of tools. It includes the Lispex Interpreter, a resource-controlled rule engine, the Lispex VM for verified bytecode, intermediate-form commands, exact Lispex Images, and the complete Lispex Vouch workflow. Native issues evidence, reruns the pinned request, and runs the local gate. It can also derive a compiled artifact from the same exact source and record Lispex VM agreement.
• Choose npm when Node is already available. It runs source, provides the same exact Lispex Image commands through Rust compiled to WASM, authenticates Vouch evidence with the same checker as Native, and replays decision corpora offline. Intermediate forms, verified bytecode, the Lispex VM, evidence issuance, current re-execution, and the local gate need Native.
• Use the Playground to run source and to create, open, page through, recover, download, and explicitly run exact images directly in your browser. Native provides intermediate forms, bytecode, and the Lispex VM, while Native and npm provide the Vouch artifact and policy tools.

All platforms

Every release file and checksum is also on GitHub Releases. The npm package and the native executables are both under the Apache License 2.0, and each release includes a notices file for the bundled libraries.

Download file version v1.21.3

A checksum identifies the exact bytes you downloaded. On macOS or Linux, keep the executable and its .sha256 file in the same folder and run this command. It prints OK when they match.

# Linux
sha256sum -c lispex-linux-x86_64.sha256

# macOS
shasum -a 256 -c lispex-macos-aarch64.sha256

In Windows PowerShell, run these two lines. The second prints True when they match.

$want = (Get-Content .\lispex-windows-x86_64.exe.sha256).Split(' ')[0]
(Get-FileHash .\lispex-windows-x86_64.exe).Hash -eq $want

On Windows, you can also run the downloaded file from its folder without installing it, with hello.lspx in the same folder.

.\lispex-windows-x86_64.exe hello.lspx

Editor extension

The official studiohaze.lispex extension recognizes .lspx files and adds syntax highlighting and the Lispex file icon for light and dark themes.

Visual Studio Marketplace · Open VSX Registry

Formatting requires Native. Format Document and format-on-save pass the document to lispex fmt - and use the formatted source it returns. If lispex is not on PATH, set lispex.format.executable to its location.

Developer components

The resource-controlled rule engine, exact bytes

Applications can pin the exact bytes of this engine. It runs one rule under the declared resource profile. Its manifest fixes capabilities, metering, value exchange, receipt fields, memory limits, and checksum. Recorded request and result bytes let every consumer compare the exact observation.

The whole-language rule engine, exact bytes

A separate component covers the complete lispex-profile-1.5 and carries its own capability, metering, component, and artifact identities. It reuses the established value exchange, run transcript, and portable record format. Native selects it through explicit embed full commands and creates a fresh instance for every operation.

Related pages

• Connect the MCP Server. Native also includes lispex mcp serve, a local MCP server for language lookup, diagnostic explanations, and trusted-source evaluation within size and time limits.
• Create and Restore Lispex Images. Store exact source in a PNG or ZIP file and recover it byte for byte in Native, npm, or the Playground.
• Lispex Vouch. Native authenticates a signed decision, reruns it with the source and input you supply, and records a local gate result. Your application decides the action.
• Products and Supported Platforms. Lists the features of each product and what a download check establishes.