Skip to main content

Getting Started

There are multiple ways in which you can get started. You can play with the language online in the playground, get the installer and play on your machine, or build the whole project yourself.


You can now try the Playground and browse through the many examples provided. It's using the same editor engine as Visual Studio Code, and has the best support for Lesma.

Using the installer

You can also just run the installer, and it will get the binary with all the dependencies and standard library installed for you. Paste the following in your Terminal:

bash -c "$(curl -fsSL"

Building from source

You can also choose to build from source, if you'd rather not, just skip this part.

To do that, uou'll need certain tools installed on your machine before attempting to build the project. Mainly, you'll need a C++ compiler, CMake and LLVM 14 installed. Since the project is being developed and tested with Clang, I would suggest you use the same.

Installing Prerequisites

On Ubuntu

Install system dependencies

sudo apt install zlib1g-dev

Install CMake

sudo apt install cmake

Install LLVM & Clang

# Run the script in the repository

Set Clang symlink to Clang 14

sudo ln -s /usr/bin/clang-14 /usr/bin/clang
sudo ln -s /usr/bin/clang++-14 /usr/bin/clang++

On macOS

MacOS already has Apple Clang installed which should be good enough as a C++ compiler.

Install system dependencies

xcode-select --install

Install CMake

brew install cmake

Install LLVM

brew install llvm@14

echo 'export PATH="/opt/homebrew/opt/llvm/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/llvm/lib -Wl,-rpath,/opt/homebrew/opt/llvm/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/llvm/include"' >> ~/.zshrc


You can now build the compiler yourself! Let's try it out.

Clone the repository

git clone

Create a build directory for the generated output

mkdir build

Build the project

cmake -B build
cmake --build build

Using Lesma

You should now see a few more files in the build directory, lesma among them. We can use it to run our Lesma sources.

Let's make a lesma input file that contains the Hello World example.

echo "print(\"Hello World\")" >> hello.les

Check how to use the CLI and available options

lesma --help

Run one of the Lesma test files

lesma run hello.les

Compile a Lesma file to binary/executable

lesma compile hello.les