Getting Started

Welcome to Libertaria. This guide will get you from zero to a running sovereign node in under 30 minutes.

Prerequisites

• Zig 0.15.2+ — ziglang.org/download
• Git — For version control
• 2+ hours — To read, build, and understand

Optional but helpful: - liboqs — For post-quantum crypto (see vendor/liboqs/) - argon2 — For key derivation (bundled in vendor/argon2/)

5-Minute Setup

# 1. Clone
git clone https://github.com/libertaria-project/libertaria-stack.git
cd libertaria-stack

# 2. Build
zig build

# 3. Test
zig build test

# 4. Run example
zig build examples
./zig-out/bin/lwf_example

Expected: All tests pass, examples run without errors.

What Next?

• Installation — Detailed setup instructions
• First Node — Run your first Capsule node
• Concepts — Core concepts and terminology

Troubleshooting

Build fails with "undefined reference to argon2"

Ensure vendor libraries are initialized:

git submodule update --init --recursive

Tests fail on ARM

Some cryptographic tests may fail on older ARM chips. This is expected — the core functionality works, but some optimized paths require ARMv8+.

Forge burns bright. ⚡