Getting Started

Brunost is a dynamically-typed, tree-walking interpreted language written in Zig. Its keywords are in Nynorsk Norwegian.

Try it online

The fastest way to explore Brunost is in the interactive browser playground. No installation required — the interpreter runs as a WebAssembly module.

Installation

Homebrew (macOS and Linux)

brew tap atomfinger/brunost
brew install brunost

asdf / mise (macOS and Linux)

asdf plugin add brunost https://github.com/atomfinger/asdf-brunost
asdf install brunost latest
asdf global brunost latest

Or with mise:

mise use -g brunost@latest

Windows

Download the latest binary from the GitHub Releases page and add it to your PATH.

Nix

nix run github:atomfinger/brunost -- yourscript.brunost

Running a script

Save a file with a .brunost extension and run it:

brunost hello.brunost
# or via the build tool:
zig build run -- hello.brunost

Your first program

bruk terminal

terminal.skriv("God dag, verd!")

Output:

God dag, verd!

The pipeline

Every Brunost program passes through three stages:

1. Lexer — source text is tokenised
2. Parser — tokens become an AST (Abstract Syntax Tree)
3. Interpreter — the AST is evaluated

WASM vs native

Some standard library modules are only available when running natively (not in the browser playground):

Module	Browser	Native
terminal	✓	✓
matte	✓	✓
streng	✓	✓
liste	✓	✓
kart	✓	✓
prosess	—	✓
fil	—	✓
nettverk	—	✓
http	—	✓