README.md

March 13, 2026 · View on GitHub

Mia

₊˚ Elle ♡︎

Elle is a procedural programming language built in Rust which compiles to the QBE backend. There is also a mirror of this repository on SourceHut.

✩ It is heavily recommended to read the FAQ before trying the language. It will allow you to grasp the strengths and weaknesses of the language at a glance and quickly learn whether this language is one you would be comfortable using.

✩ You can view the Elle documentation here. Please note the language is still in active development and documentation is due to change at any time with no warning.

♡ Hello, World!

use std/prelude;

fn main() {
    $println("Hello world!");
}

♡ Projects made in Elle

Project	Description	Image	More
Raytracer	A pathtracer experiment using Raylib & OpenGL rendering scenes with up to 4.4 million triangles.
Black Hole	A simplified black hole simulation in real time using Raylib and OpenGL.
Peephole	A speculative dystopia horror game designed around looking through a peephole.
AOC2025	All Advent of Code problems in 2025 completed in Elle, running in 404.1ms ± 3.6ms cumulatively on an M4 MacBook Air.

♡ How to run

Ensure you have Rust, Cargo and the QBE compiler backend.

git clone https://github.com/acquitelol/elle

cd elle

(does not require root)

make

to install the compiler, standard library, and runtime (installs into ~/.local/ by default)

Add the compiler executable to your $PATH:

export PATH="$HOME/.local/bin:$PATH"

  $ make compile-release

to get only a compiler executable and not install anything.

♡ You can now run `ellec` to get a help message of how to use the compiler!

Try compiling a simple example!

ellec ./examples/hello.le --run

Try compiling an example with libraries!

ellec ./examples/graphics/newton.le -z -lraylib --run

♡ Licensing

Please read LICENSE.md