Installation¶

Windows (standalone installer)¶

Download the installer from the download page. It bundles luz.exe, ray.exe, the standard libraries, and optionally example programs. No Python required.

After installation, luz and ray are available from any terminal:

luz program.luz   # run a file
luz               # open the REPL

From source¶

Requires Python 3.8 or higher. No external dependencies.

git clone https://github.com/Elabsurdo984/luz-lang.git
cd luz-lang
python main.py          # open the REPL
python main.py file.luz # run a file

No build step, no package manager, no virtual environment needed.

VS Code extension¶

A full-featured language extension for VS Code is included in the vscode-luz/ folder:

Copy vscode-luz/ to ~/.vscode/extensions/
Restart VS Code

Features: syntax highlighting, autocompletion, inline error detection, hover documentation, and snippets.

Optional: build the C lexer¶

For faster tokenisation, compile the C lexer (requires MSYS2 on Windows):

cd luz/c_lexer
make

The interpreter automatically uses luz_lexer.dll (Windows) or luz_lexer.so (Linux/macOS) if it is present.