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.
| Mode | Inputs and requirements | Limits to account for |
|---|---|---|
| Browser or desktop extension | A complete source buffer with fn main() | 256 KiB source, 64 KiB output and an eight-second worker deadline. |
| CLI interpreter | A .blyx file and the blyxc executable | Default one million evaluation steps and at most 64 simultaneous calls. |
| Native build | A supported typed program, rustc and a host linker | The 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.