// DOCUMENTATION

Build from source

Compile the Koko browser runtime with Zig — for engine contributors, not everyday SDK users.

Development

Building Koko from source is for engine development and contributors. If you only want to automate pages or run agents, use the Quick start with the SDK and a prebuilt Koko binary — no compiler required.

Prerequisites

  • Zig 0.15.2 — pinned version; other Zig releases may not compile
  • V8 — JavaScript engine linked at build time
  • libcurl — network stack for page loads
  • Rust toolchain — required native dependencies in the build graph
  • Node.js — for the TypeScript SDK and benchmark scripts

See Requirements for the full toolchain list.

Clone and build

git clone https://github.com/ivanUri/koko-core
cd koko-core
zig build

On success:

zig-out/bin/koko

Verify

zig-out/bin/koko --help
zig build run -- --help

Build the SDK

npm run build:sdk

After building, Browser.launch() finds zig-out/bin/koko automatically when run from the repo.

Common issues

  • Wrong Zig version — install exactly 0.15.2
  • Missing V8 — follow platform-specific setup in the repo build docs
  • Slow first build — V8 compilation can take several minutes on first run