Quickstart

Build and run the examples

From the repo root:

zig build examples

The Zig build installs binaries under zig-out/bin/.

Expected example binaries:

• zig-out/bin/zig-example (source: examples/zig/ping.zig) — minimal spawn + stop
• zig-out/bin/zig-typed-actor (source: examples/zig/typed_actor.zig) — typed wrapper example
• zig-out/bin/zig-supervisor (source: examples/zig/supervisor.zig) — restart modes + deterministic driver
• zig-out/bin/zig-echo-server (source: examples/zig/echo_server.zig) — I/O watchers + TCP echo

Suggested run order:

1. ./zig-out/bin/zig-example
2. ./zig-out/bin/zig-typed-actor
3. ./zig-out/bin/zig-supervisor
4. ./zig-out/bin/zig-echo-server 5555 and then nc 127.0.0.1 5555

Deep-dive walkthroughs (with code snippets + explanations):

• Zig ping example
• Zig typed actor example
• Zig supervisor example
• Zig echo server example

Stress tool (optional)

From the repo root:

zig build stress

This runs the smoke variant by default. You can also run the installed binary directly:

./zig-out/bin/jzx-stress --smoke

Deep dive:

• Stress tool walkthrough

C examples

The repository includes plain C examples under examples/c/.

If you prefer compiling them directly (bypassing Zig), see the commands in the repo root README.md.

Next

• Architecture

See also

• Installation
• Configuration
• Configuration reference
• Deep dive: source index