Trinity Network

Decentralized Ternary AI Inference + Sacred Computing
Run LLMs on your CPU. Earn $TRI tokens. No GPU required.

Quick Start • Docker Node • $TRI Token • Architecture • CLI • Docs

What is Trinity?

Trinity is a DePIN (Decentralized Physical Infrastructure Network) for ternary AI inference and sacred computing. It uses balanced ternary arithmetic {-1, 0, +1} to run LLM inference on ordinary CPUs -- no GPU required.

🆕 KOSCHEI AWAKENS v7.0 — Sacred Computing Platform

Cycle 110 Public Release — February 28, 2026

KOSCHEI AWAKENS is the world's first sacred computing virtual machine with:

• 41 Sacred Opcodes (0x80-0xFF) for mathematics, chemistry, and physics
• Ternary Computing {-1, 0, +1} with 1.58 bits/trit information density
• Proven 603x Formula: 7x (JIT) × 3x (AVX2) × 20x (Tables) × 1.4x (Large) = 588x
• Production-Ready VM available today

Learn more:

• Investor Deck v1.0
• Sacred v7.0 Architecture
• Cycle 110 Announcements

Why ternary?

The mathematical foundation: radix 3 is the optimal integer radix (closest to e = 2.718). The golden ratio encodes this: phi^2 + 1/phi^2 = 3 (Trinity Identity).

Quick Start

Docker (recommended)

docker pull ghcr.io/ghashtag/trinity-node:latest

docker run -d --name trinity-node \
  -p 8080:8080 -p 9090:9090 -p 9333:9333/udp -p 9334:9334 \
  -v ~/.trinity:/data \
  ghcr.io/ghashtag/trinity-node:latest

Check health:

curl http://localhost:8080/health
# {"status":"ok","model":"loaded"}

Build from source

git clone https://github.com/gHashTag/trinity.git
cd trinity
zig build              # Build all targets
zig build tri          # Build the unified TRI CLI
zig build test         # Run all tests

Requires Zig 0.15.x.

Docker Node

The Trinity node Docker image is published to GitHub Container Registry on every push to main.

Ports

Data volume

Mount -v ~/.trinity:/data to persist wallet, shards, and config across restarts.

Stop / Restart

docker stop trinity-node     # Stop
docker start trinity-node    # Restart (keeps data)
docker rm trinity-node       # Remove container (data persists in ~/.trinity)

$TRI Token

$TRI is deployed on Ethereum Sepolia testnet. Mainnet deployment is planned.

Allocation

Staking Tiers

Your staked $TRI determines your API tier. No API keys -- your wallet is your identity.

Include X-Wallet: 0xYOUR_ADDRESS in HTTP headers. See Tokenomics docs for full details.

Architecture

Core VSA System

DePIN Node

Firebird LLM Engine

VIBEE Compiler

Production Swarm (v8)

One-command 32-agent Trinity cluster:

# Run demo
./demo/v8_production_swarm.sh

# Or directly
zig build vibee -- gen specs/tri/vsa_swarm_production_32.vibee
zig build swarm
./zig-out/bin/swarm-runtime

Features:

• 32 agents with phi-spiral consensus (φ² + 1/φ² = 3)
• Self-healing with auto-recovery
• Prometheus metrics on :9090
• Self-improvement cycle (analyzes & regenerates patterns)

Docker deployment:

cd deploy && docker compose up -d
# Prometheus: :9091, Grafana: :3000

Kubernetes deployment:

kubectl apply -f deploy/k8s/
kubectl port-forward svc/trinity-swarm-metrics 9090:9090

HTTP API

The node exposes an OpenAI-compatible API on port 8080.

# Chat completion
curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-Wallet: 0xYOUR_WALLET" \
  -d '{"model":"trinity-llm","messages":[{"role":"user","content":"Hello"}]}'

# Node stats
curl http://localhost:8080/v1/node/stats

# Storage
curl -X POST http://localhost:8080/v1/storage/put \
  -H "Content-Type: application/octet-stream" \
  --data-binary @myfile.bin

# Prometheus metrics
curl http://localhost:9090/metrics

See API Reference for full documentation.

TRI CLI

Single command for all Trinity features:

zig build tri

# Available commands
tri                    # Interactive REPL
tri code fibonacci     # Generate code
tri chat "hello"       # Chat
tri explain <file>     # Explain code
tri fix <file>         # Fix bugs
tri test <file>        # Generate tests
tri help               # Full help

Multilingual: Russian, English, Chinese -- auto-detected.

DePIN Reward System

Nodes earn $TRI through Proof-of-Useful-Work -- every rewarded computation produces a real, verifiable result.

Bonus multipliers: fitness > 0.9 grants +50%, similarity > 0.8 grants +100%, staking 100+ TRI grants 1.5x on all earnings.

Project Structure

trinity/
├── src/                    # Core Zig source
│   ├── vsa.zig             # Vector Symbolic Architecture
│   ├── vm.zig              # Ternary Virtual Machine
│   ├── hybrid.zig          # HybridBigInt (1.58 bits/trit)
│   ├── trinity_node/       # DePIN node (HTTP API, staking, config)
│   ├── firebird/           # LLM engine + DePIN rewards
│   ├── vibeec/             # VIBEE compiler + IGLA agent
│   ├── b2t/                # BitNet inference
│   ├── phi-engine/         # Quantum-inspired computation
│   └── tvc/                # Ternary Vector Computing
├── deploy/                 # Docker configs
│   └── Dockerfile.node     # Multi-stage Alpine build
├── contracts/              # Solidity (TrinityToken.sol)
├── specs/                  # .vibee specifications
├── docsite/                # Documentation site (Docusaurus)
├── website/                # Landing page (Vite + React)
├── libs/                   # Multi-language VSA libraries
└── build.zig               # Build system

Documentation

🤖 Autonomous Development (Ralph)

Trinity uses the Ralph Loop for sustained autonomous development, optimization, and code generation.

[!TIP] 🐣 New to Ralph? Read our Beginner's Guide to Ralph to understand how to add tasks and use the autonomous workflow effectively.

Installation

To use Ralph, you must first install it globally:

git clone https://github.com/frankbria/ralph-claude-code.git
cd ralph-claude-code
./install.sh

Quick Start

Navigate to the Trinity root and run:

ralph --monitor        # Recommended: Start Ralph with live monitor in tmux

Custom Autonomy Tools

We've integrated specialized scripts in the .ralph/ directory to ensure high-fidelity work:

Workflow (The Golden Chain)

1. Define: Edit or create a specification in specs/tri/*.vibee.
2. Plan: Update .ralph/fix_plan.md with your next objective and acceptance criteria.
3. Run: Execute ralph --monitor.
4. Verify: Ralph will automatically generate code, run tests, and check performance via the quality gates.
5. Commit: Upon success, Ralph updates .ralph/SUCCESS_HISTORY.md and proposes next Tech Tree nodes.

For detailed development protocols and constraints, see .ralph/RULES.md.

Build Commands

zig build                    # Build all targets
zig build tri                # Unified TRI CLI
zig build test               # Run ALL tests
zig build bench              # Run benchmarks
zig build release            # Cross-platform release builds
zig build vibee              # VIBEE Compiler CLI
zig build firebird           # Firebird LLM CLI
zig fmt src/                 # Format code

Contributing

git clone https://github.com/gHashTag/trinity.git
cd trinity
zig build test               # Run all tests before submitting PRs

See CONTRIBUTING.md for guidelines.

License

MIT -- see LICENSE

phi^2 + 1/phi^2 = 3 = Trinity
3^21 = 10,460,353,203 $TRI