Installation

Beloch’s evaluator core is written in OCaml. The repo ships a Nix flake that provides the full OCaml toolchain (dune, menhir, sedlex, ocaml-lsp, …).

Prerequisites

• Nix with flakes enabled, or a working OCaml + dune setup and Bun for the docs site
• direnv (recommended) — direnv allow drops you into the dev shell automatically

Build the CLI

# Option A — dev shell (direnv or nix develop)
direnv allow          # or: nix develop
dune build
dune exec beloch -- --version

# Option B — Nix build (no dev shell needed)
nix build             # produces ./result/bin/beloch

The CLI exposes beloch fold FILE.bel, which evaluates a program and emits FOLD JSON on stdout.

Build the docs site

cd site
bun install
bun run build         # runs beloch for every <Beloch> component on the page

The build resolves the binary from _build/default/bin/main.exe (dev shell build) or you can point it elsewhere:

BELOCH_BIN=/path/to/beloch bun run build