This repository contains experimental implementations of the OuroLang programming language.

The recommended way to compile the project is via Zig:

zig build

This compiles the REPL and all supporting modules using C23/C++23 and links against LLVM. Run the modular demo with:

zig build mod-run

Execute its unit tests using:

zig build mod-test

If Zig is unavailable you can still build the simple interpreter directly:

g++ -std=c++23 ouro_lang.cc -o ouro_lang
./ouro_lang

A Zig build script is also included (build.zig) for environments with the Zig compiler installed. It compiles the C portions of the project using the C23 standard and links against LLVM in addition to libc. The script mirrors the old CMake setup and exposes tasks for running the module example and its unit tests. If Zig is missing locally, run scripts/install_zig.sh to download version 0.14.1.

The project includes tests, a development container, and extensive documentation.

The ouro_mod directory showcases a minimal C++23 module setup. Build and run the modular example with:

zig build mod-run

Run its tests using:

zig build mod-test

Detailed design notes live in the docs/ directory. The evolving language specification is provided in OuroLang_Spec_2_0.md and outlines syntax, semantics and concurrency features currently implemented. The specification now includes a Types section describing primitive datatypes and short examples of control flow. Community contributions are welcome—see docs/contrib.md for guidelines.

Experimental AFL++ harnesses live in tools/fuzz. They can be built with CMake using -DENABLE_FUZZ=ON and run against the sample corpus in tools/fuzz/corpus to discover crashes in the lexer and parser.

The ouroboros-lang directory tracks the original C implementation of the language from the FyreFly-TM/ouroboros-lang project. Use the provided Makefile to build the interpreter and run example scripts such as test_all_tokens.ouro. Binary build artifacts and bundled node_modules have been removed from version control.