<p align="center"> <img src="https://github.com/acquitelol/elle/blob/rewrite/images/mia_512x.png?raw=true" alt="Mia" width="256"> </p> <h2 align="center"> <strong> ₊˚ Elle ♡︎ </strong> </h2>

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. | <img src="https://github.com/acquitelol/raytracer/raw/mistress/images/new_dragon.png?raw=1" width="240"> | | | Black Hole | A simplified black hole simulation in real time using Raylib and OpenGL. | <img src="https://github.com/acquitelol/blackhole/raw/mistress/assets/out2.gif?raw=1" width="240"> | | | Peephole | A speculative dystopia horror game designed around looking through a peephole. | <img src="https://github.com/acquitelol/peephole/raw/mistress/assets/example.png?raw=1" width="240"> | | | 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"

OR

  $ 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
• Copyright © 2024 Rosie (acquitelol)

<a href="#top">⇡ Back to top️!</a>