Skip to content

Installation and First Run

Test User edited this page Mar 28, 2026 · 1 revision

Installation and First Run

Getting Started

This guide gets you from source code to a running KodPix program.

Requirements

  • Linux x86-64
  • NASM 2.15+
  • GNU ld

Build the Compiler

./build.sh

The compiler binary is created as ./kdx.

Compile and Run a Program

./kdx examples/hello.kdx -o hello
./hello

One-command helper:

./scripts/run_kdx.sh examples/add_two_vars.kdx

Output Modes

  • Assembly only:
./kdx examples/hello.kdx -S -o hello.s
  • Object only:
./kdx examples/hello.kdx -c -o hello.o

First Program

function int main() {
    println("Hello, KodPix");
    return 0;
}

Next Steps

  • Language rules: docs/language/reference.md
  • Error meanings: docs/language/error-codes.md
  • Practical examples: docs/language/cookbook.md

Clone this wiki locally