// DOCUMENTATION

Requirements (Zig, V8)

Toolchain and system dependencies for building Koko.

Development

Koko requires a specific toolchain stack. Versions are pinned for reproducible builds.

Required

DependencyVersion / notes
Zig0.15.2 — other versions may fail to compile
V8Linked at build time — platform setup in build docs
libcurlNetwork stack for page loads
Rust toolchainRequired native dependencies
Node.jsSDK, CLI, benchmarks, and code-check scripts

Optional (benchmarks)

  • Playwright Chromium — npx playwright install chromium
  • npm dependencies — npm install at repo root

Platform notes

  • macOS arm64 — primary development platform (Apple Silicon)
  • Linux — supported with platform-specific V8 setup
  • First build can take several minutes while V8 and deps compile

Verify installation

zig version    # expect 0.15.2
zig build
zig-out/bin/koko --help
node --version
npm run build:sdk