Home

Welcome to the Havel wiki!

Here you'll find everything you need to write Havel scripts, embed the VM, or contribute to the language.

Quick Links Installation — Get Havel running on your system

Language Tour — 5 minutes to basic syntax

Standard Library — Built-in modules reference

FFI Guide — Call C libraries directly from Havel

Core Concepts Variables and Types

Control Flow — if, for, while, match

Functions — Closures, lambdas, default arguments

Structs and Classes

Modules and Imports

Error Handling — try/catch/finally

Concurrency Fibers and Scheduler — Lightweight concurrency

Threads — OS-level threads (careful!)

Channels — Message passing between fibers

Async/Await — Promise-based async

Advanced Topics Embedding Guide — Call Havel from C++

Host Functions — Expose C++ functions to Havel

Bytecode Format — For tool builders

JIT Compilation — LLVM-based native code

FFI Deep Dive — Full C interop reference

Development Building from Source

Contributing Guide

Architecture Overview

Testing — Running the test suite

Community GitHub Repository

Examples — Scripts to get started

Havel is under active development. Some features may change. See CHANGELOG for updates.