Installation

Get GocciaScript on your machine.

Pick the install method that fits your platform. The runtime is a single self-contained binary — no Node.js, no toolchain, no global state.

Pre-1.0 release. The public API is still being shaped — anything documented can change between any two releases until 1.0.0 ships. Pin a specific version in CI and check the release notes before upgrading.

Latest version 0.13.0 released August 19, 2026

Release notes Source on GitHub

Homebrew#

On macOS, install the latest release from the maintained frostney/homebrew-tap. Homebrew places the GocciaScript tools on your $PATH and handles upgrades.

bash
brew install frostney/tap/gocciascript

Pre-built binaries#

Download the archive for your OS / arch from the GitHub release. It carries the whole toolchain — GocciaScriptLoader (the runtime), GocciaScriptLoaderBare, GocciaSandboxRunner, GocciaTestRunner, GocciaBundler, GocciaBenchmarkRunner, GocciaREPL, GocciaFuzzHarness, and GocciaWasmTestRunner — plus the tests/, benchmarks/, and examples/ directories, all inside one versioned folder named after the archive. The commands below put the three most common binaries on your $PATH; the rest are yours to copy from that folder.

bash
# Apple Silicon (arm64) — auto-detected
curl -fsSL -O "https://github.com/frostney/GocciaScript/releases/download/0.13.0/gocciascript-0.13.0-macos-arm64.zip" && \
unzip -q "gocciascript-0.13.0-macos-arm64.zip" && \
cd "gocciascript-0.13.0-macos-arm64" && \
chmod +x GocciaScriptLoader GocciaTestRunner GocciaREPL && \
sudo mv GocciaScriptLoader GocciaTestRunner GocciaREPL /usr/local/bin/
​
# Intel (x64) — uncomment to use instead
# curl -fsSL -O "https://github.com/frostney/GocciaScript/releases/download/0.13.0/gocciascript-0.13.0-macos-x64.zip" && \
# unzip -q "gocciascript-0.13.0-macos-x64.zip" && \
# cd "gocciascript-0.13.0-macos-x64" && \
# chmod +x GocciaScriptLoader GocciaTestRunner GocciaREPL && \
# sudo mv GocciaScriptLoader GocciaTestRunner GocciaREPL /usr/local/bin/

Build from source#

FreePascal compiler required. Clone, run the build script, then point your $PATH at ./build.

Delphi 12 Community Edition is also supported for the complete shipped Win32 and Win64 application matrix. Open the repository project group and follow the build and validation guide.

bash
git clone https://github.com/frostney/GocciaScript
cd GocciaScript
./build.pas loader testrunner repl
./build/GocciaScriptLoader --help

Next

Read the docs for a full language tour, or jump straight into the Playground to try the runtime in your browser.