Getting Started

Prerequisites

Install CMake 4.1 or newer, LLVM 18.x, and a C++20-capable host compiler.

Build The Compiler

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DLLVM_DIR=/path/to/llvm-18/lib/cmake/llvm
cmake --build build

That produces build/aburi.

Try C

./build/aburi sample_c/hello_stdio.c -o hello_c
./hello_c

Try C++

./build/aburi sample_cpp/classes.cpp -o classes_cpp
./classes_cpp

More Samples

Useful C samples:

  • sample_c/records_and_vla.c

  • sample_c/c11_features.c

  • sample_c/blocks.c

  • sample_c/attributes_and_builtins.c

  • sample_c/varargs.c

Useful C++ samples:

  • sample_cpp/classes.cpp

  • sample_cpp/references.cpp

  • sample_cpp/templates.cpp

  • sample_cpp/overloads.cpp

  • sample_cpp/namespaces.cpp

  • sample_cpp/member_pointers.cpp

Next Steps

Read Command-Line Usage for compilation modes and driver flags, then C Features and C++ Features for the current feature surface.