Skip to main content

Installation

Complete installation guide for Trinity.

System Requirements​

RequirementMinimum
Zig0.13.0
RAM4 GB
Disk1 GB

Installing Zig​

macOS​

# Option 1: Direct download (recommended)
curl -LO https://ziglang.org/download/0.13.0/zig-macos-aarch64-0.13.0.tar.xz
tar -xf zig-macos-aarch64-0.13.0.tar.xz
export PATH="$PWD/zig-macos-aarch64-0.13.0:$PATH"

# Option 2: Homebrew
brew install zig@0.13

Linux​

curl -LO https://ziglang.org/download/0.13.0/zig-linux-x86_64-0.13.0.tar.xz
tar -xf zig-linux-x86_64-0.13.0.tar.xz
export PATH="$PWD/zig-linux-x86_64-0.13.0:$PATH"

Windows​

  1. Download from https://ziglang.org/download/
  2. Extract to C:\zig
  3. Add C:\zig to PATH

Verify Installation​

zig version
# Output: 0.13.0

Clone Repository​

git clone https://github.com/gHashTag/trinity.git
cd trinity

Build​

# Build all
zig build

# Build specific target
zig build firebird # LLM CLI
zig build release # Cross-platform builds

Verify Installation​

# Run tests
zig build test

# Or test specific module
zig test src/vsa.zig

Troubleshooting​

Zig Version Mismatch​

If you see errors like no field named 'addStaticLibrary', you have the wrong Zig version.

Solution: Install Zig 0.13.0 as shown above.

Build Failures​

Try running tests directly:

zig test src/vsa.zig  # Bypasses build.zig

Next Steps​