BlyxDocumentation
Browse chapters
Documentation / Language reference

What Blyx 0.2.1 can run

Choose an execution mode and identify features that are still being developed.

Choose an execution mode

Use the CLI interpreter or browser for immediate feedback. Use a native build to distribute a supported typed program to a compatible host. The editor and playground run the interpreter compiled to WebAssembly.

ModeInputs and requirementsLimits to account for
Browser or desktop extensionA complete source buffer with fn main()256 KiB source, 64 KiB output and an eight-second worker deadline.
CLI interpreterA .blyx file and the blyxc executableDefault one million evaluation steps and at most 64 simultaneous calls.
Native buildA supported typed program, rustc and a host linkerThe generated program runs with system resources; interpreter step and call budgets do not apply.

Supported execution

The teaching examples use functions, local bindings, scalar arithmetic, loops, recursion, numeric vectors and print macros. Native programs can import local .blyx modules and read command-line arguments or UTF-8 files through the host library. Use native-run or build for multi-file applications.

Features under development

The package registry and its dependency resolver are prototypes. The published source libraries use versioned Git checkouts. The browser and CLI interpreter execute a single source buffer. GPU kernels, a general tensor runtime, asynchronous tasks and actor scheduling remain development work.

Interpret a benchmark

Measure the same workload, input size and output across the implementations you compare. Separate startup costs from computational work when they answer different questions. The project’s published Fibonacci benchmark includes startup and reports its machine, raw samples and methodology.

Practice

Decide how to deliver a small numeric utility to a colleague who has no compiler installed. What do you need on each machine?

Hint

Distinguish the machine doing the build from the machine running the result.

Worked solution

On a suitable build host use blyxc, rustc and a linker to build the typed source. Deliver the executable for your colleague’s compatible OS and architecture. Try a small known input on the destination machine.

Browse performance measurements