Skip to main content

API Reference

Complete API documentation for Trinity modules.

Core Modules​

ModuleDescription
VSAVector Symbolic Architecture (Zig)
VMTernary Virtual Machine
HybridHybridBigInt storage
SDKHigh-level developer API
FirebirdLLM inference engine
VIBEESpecification compiler
PluginExtension system

SDK Bindings​

ModuleDescription
C API (libtrinity-vsa)22-function C library — SIMD-accelerated, 70 KB
Python SDKctypes binding — NativeVSA + Vector classes

Quick Reference​

SDK (High-Level API)​

// Hypervector operations
var hv = Hypervector.random(1000, 42);
var bound = key.bind(&value);
var combined = a.bundle(&b);
const sim = a.similarity(&b); // [-1, 1]

// Codebook for symbols
var codebook = Codebook.init(allocator, 1000);
const cat = try codebook.encode("cat");
const symbol = codebook.decode(&query);

// Associative memory
var memory = AssociativeMemory.init(1000);
memory.store(&key, &value);
var retrieved = memory.retrieve(&key);

VSA (Low-Level API)​

vsa.bind(a, b)              // Create association
vsa.unbind(bound, key) // Retrieve from binding
vsa.bundle2(a, b) // Combine 2 vectors
vsa.cosineSimilarity(a, b) // Compare vectors [-1, 1]
vsa.hammingDistance(a, b) // Count differences
vsa.permute(v, count) // Cyclic shift

HybridBigInt​

var v = HybridBigInt.zero();       // Zero vector
var v = HybridBigInt.random(1000); // Random vector
v.pack(); // Memory efficient
v.ensureUnpacked(); // Compute efficient

CLI Commands​

tri gen <spec.vibee>              # Generate code from spec
tri chat "Hello" # Interactive AI chat
tri serve --port 8080 # HTTP API server
tri doctor # System health check
tri full-autonomous # Full system report

See also: TRI CLI Reference for the complete CLI documentation with 190+ commands.