Download Geblang

Geblang ships as a single self-contained binary. Grab a pre-built release for your platform, or build from source.

Pre-built binaries

Download the archive for your platform from the latest release, then follow the install steps below.

Current release: 1.33.0. Verify downloads against checksums.txt in the release.

Install

On Linux and macOS, extract the archive and move geblang onto your PATH. Verify your download against checksums.txt in the same release.

tar -xzf geblang_<version>_linux_amd64.tar.gz
sudo mv geblang /usr/local/bin/
geblang --version

On Windows, unzip the archive and add the folder containing geblang.exe to your PATH.

macOS binaries are not yet notarized, so the first run may be blocked by Gatekeeper; allow it under System Settings, or clear the quarantine attribute with xattr -d com.apple.quarantine ./geblang.

Run Geblang with Docker

The official Geblang Docker image includes the Geblang CLI and standard library. It is useful for trying Geblang without a local installation and for running the same toolchain in development and CI.

Pull the current image and confirm the installed version:

docker pull dwgebler/geblang:latest
docker run --rm dwgebler/geblang:latest --version

For repeatable builds, replace latest with a release tag such as dwgebler/geblang:<version>.

Run Geblang files from your project

The image works from /app. Mount the current directory there to check or run source files without copying them into an image. If the project keeps its test files under tests/, run that directory as a suite:

docker run --rm -v "$PWD:/app" dwgebler/geblang:latest check hello.gb
docker run --rm -v "$PWD:/app" dwgebler/geblang:latest run hello.gb
docker run --rm -v "$PWD:/app" dwgebler/geblang:latest test tests/

Build a Linux executable

With a main.gb entry module that exports main(), a mounted output path writes the compiled binary back to the project directory. The resulting executable targets Linux because the compiler is running inside the Linux container. See the bundling guide for package layouts and entry-point rules.

docker run --rm -v "$PWD:/app" dwgebler/geblang:latest \
  build --entry main --out hello
./hello

Build from source

You need Go 1.26 or newer. Clone the repository, run make build, and move the binary onto your PATH:

git clone https://github.com/dwgebler/geblang
cd geblang
make build              # produces ./geblang

No Go toolchain? make docker-build builds inside a container.

Editor support

A VS Code extension ships with the toolchain for syntax highlighting, completion, hover docs, and step debugging.

Claude Code skills

Skills that teach Claude Code about Geblang and Gebweb - the language, toolchain, and stdlib, plus Gebweb app authoring and testing - ship with each release. Download a skill above and unzip it into your Claude skills directory:

unzip -d ~/.claude/skills geblang-claude-skill-<version>.zip