Skip to content

README.md

Latest commit

 

History

History
84 lines (61 loc) · 1.87 KB

README.md

File metadata and controls

84 lines (61 loc) · 1.87 KB

Zero

Zero is the programming language for agents: a systems language for small native tools, explicit effects, predictable memory, and structured compiler output.

Zero is experimental and still changing. The compiler, standard library, docs, and examples are useful for trying the language and giving feedback, but the language is not stable yet.

Quick Start

Install the latest release:

curl -fsSL https://zerolang.ai/install.sh | bash
export PATH="$HOME/.zero/bin:$PATH"
zero --version

Check a program:

zero check examples/hello.0

Run a small executable:

zero run examples/add.0

Expected output:

math works

Learn Zero

  • docs-site/articles/getting-started.md: build the compiler and run a first program.
  • docs-site/articles/learn-zero.md: a practical tour of the language.
  • docs-site/articles/language-reference.md: syntax and behavior reference.
  • examples/README.md: examples grouped by concept.

Run the docs site locally:

npm run docs:dev

Common Commands

zero check examples/hello.0
zero run examples/add.0
zero build --emit exe --target linux-musl-x64 examples/add.0 --out .zero/out/add
zero graph --json examples/systems-package
zero size --json examples/point.0
zero routes --json examples/web/hello
zero skills get zero --full
zero doctor --json

Validation

npm run docs:test
npm run conformance
npm run native:test
npm run command-contracts

Benchmarks run locally by default:

npm run bench

Repository Layout

  • native/zero-c/: native compiler implementation.
  • compiler-zero/: Zero-authored compiler sources.
  • examples/: runnable Zero source examples.
  • conformance/: language and CLI behavior fixtures.
  • docs-site/: documentation site.
  • tests/: TypeScript tests for CLI behavior.
  • extensions/vscode/: editor syntax highlighting for .0 files.