VIBEE Language

Sacred Formula: V = n × 3^k × π^m × φ^p × e^q Golden Identity: φ² + 1/φ² = 3

Overview

TRINITY OS is the native ternary operating system built on VIBEE.

VIBEE is a specification-first programming language that generates code from behavioral specifications. Built on the Creation Pattern and Predictive Algorithmic Systematics (PAS) methodology.

.vibee (specification) → vibee gen → .zig (auto-generated)
                       → vibee gen-multi → 42 languages!
                       → vibee gen-hdl → Synthesizable Verilog

⚡ FPGA / HDL / HLS (High-Level Synthesis)

VIBEE is a powerful HLS compiler that turns high-level specifications into ready-to-synthesize Verilog HDL.

• Multi-Language Hardware: Write logic in Python, Rust, or Go and get Verilog.
• Vendor Portability: Built-in abstraction for Xilinx (AMD), Intel (Altera), and Lattice.
• Performance Reporting: Cycle-accurate latency estimation and automated pipelining (pipeline: auto).
• BitNet Acceleration: Optimized for ternary neural network inference on FPGA.

Hardware Guide (EN) | Hardware Guide (RU) | Technical Reference

🔬 Verified in Silicon

Makerchip Simulation: Valid synchronous clocking and functional logic verification for 300MHz BitNet Core.

📦 Installation

Note: Pre-built binaries in bin/ are for Linux x86_64 with modern CPU extensions (AVX/SSE). If you get Illegal instruction, rebuild for your architecture:

Option 1: Automatic installer (recommended)

# Run bootstrap installer
curl -sSL https://raw.githubusercontent.com/gHashTag/vibee-lang/main/install.sh | bash

Option 2: Package Managers (Global)

macOS (Homebrew):

brew tap ghashtag/tap
brew install vibee

Windows (Chocolatey): Pending feed approval.

Option 3: Docker (no Zig installation needed)

# Generate Verilog directly (multi-arch image)
docker run --rm -v $(pwd):/app ghcr.io/ghashtag/vibee gen specs/tri/bitnet_top.vibee

# Build image locally (supports amd64/arm64)
docker buildx build --platform linux/amd64,linux/arm64 -t vibee .
docker run --rm -v $(pwd):/app vibee gen specs/tri/bitnet_top.vibee

# For single architecture (faster):
# docker build -t vibee .

Option 4: Manual build

# 1. Install Zig (v0.13.0 - v0.15.2 supported)
# Ubuntu/Debian:
sudo apt update && sudo apt install zig

# macOS:
brew install zig@0.13

# Or download from ziglang.org

# 2. Build compiler
cd src/vibeec
zig build -Doptimize=ReleaseSafe  # Safe for all CPUs
cp zig-out/bin/vibeec ../../bin/vibee

# 3. Verify
cd ../..
./bin/vibee --help

Platform-specific binaries

Platform	Command	Notes
Linux x86_64	./bin/vibee	Works on modern CPUs
macOS ARM64	Rebuild with Zig	zig build -Dtarget=aarch64-macos
Windows WSL2	Same as Linux	Use Ubuntu WSL2
Docker	ghcr.io/ghashtag/vibee	Multi-arch support

Need help? Open an issue or check docs/INSTALLATION.md.

🌍 GEN-MULTI: 42 Languages

One specification → 42 programming languages!

# Generate Python code
vibee gen-multi specs/tri/feature.vibee python

# Generate ALL 42 languages
vibee gen-multi specs/tri/feature.vibee all

Supported Languages:

Tier	Languages
Primary	Zig, Python, Rust, Go, TypeScript, WASM
Enterprise	Java, Kotlin, Swift, C, C#
Scripting	Ruby, PHP, Lua, Perl, R
Functional	Haskell, OCaml, Elixir, Erlang, F#, Scala, Clojure
Systems	D, Nim, Crystal, Julia, Odin, Jai, V
Classic	Ada, Fortran, COBOL, Pascal, Objective-C
JVM	Groovy, Dart
Lisp	Racket, Scheme, Common Lisp
Logic	Prolog, Gleam

🚀 Quick Start

# Validate specification before generation
vibeec validate specs/tri/feature.vibee

# Generate Zig code from specification
vibee gen specs/tri/feature.vibee

# Generate for multiple languages
vibee gen-multi specs/tri/feature.vibee all

# Test generated code
zig test trinity/output/feature.zig

# Run all tests (parallel)
cd trinity/output && ls *.zig | xargs -P 8 -I {} zig test {}

✅ Specification Validator

Validate .vibee specifications before generating code:

# Validate a single specification
vibeec validate specs/tri/core/absolute_security_v126.vibee

# Use standalone validator
./src/vibeec/bin/vibeec-validator specs/tri/core/absolute_security_v126.vibee

Validation Rules:

• ✅ Mandatory output: field required
• ✅ Must be in subfolder (specs/tri/core/, not root)
• ✅ .tri extension forbidden (use .vibee only)

Example Output:

╔══════════════════════════════════════════════════════════════════╗
║              VIBEE SPECIFICATION VALIDATION ERRORS               ║
╚══════════════════════════════════════════════════════════════════╝

❌ Missing mandatory 'output:' key

❌ Validation FAILED

Build Validator:

cd src/vibeec
zig build-exe validator_main.zig -femit-bin=bin/vibeec-validator

🛠️ Tools

py2vibee - Python to VIBEE Converter

Convert Python code to .vibee specifications for FPGA/software targets:

# Convert Python to VIBEE spec
py2vibee adder.py --target varlog --output adder.vibee

# Generate Verilog from spec
vibee gen specs/tri/adder.vibee

Features:

• AST parsing & type inference
• Multi-target: varlog, verilog, zig, python, rust, go
• Hardware signal generation
• BDD-style behavior specifications

Source: specs/tri/py2vibee.vibee (auto-generated tool)

🔥 Key Features (January 2026 - RELEASE)

Feature	Description	Status
Multi-Zig Support	Compatible with Zig 0.13.0 up to 0.15.2	✅ READY
Global Distribution	Brew & Chocolatey support	✅ READY
iGLA v6 IMMORTAL	15000× inference speedup	✅ READY
KOSCHEI MODE	Autonomous self-evolution	✅ READY
RAG Pipeline	Retrieval-Augmented Generation	16
Agent Browser	Chromium + Monaco + AI Agent	32
GEN-MULTI	Code generation for 42 languages	42
FPGA / HLS	Synthesizable Verilog & vendor abstraction	✅
Cycle-Accurate	Automated latency & pipeline analysis	✅
FFI System	Integration with 40 languages	40
E2E Pipeline v21	Chrome CDP + Ollama LLM Agent	4
BitNet Benchmark	FPGA performance benchmarking	12

🤖 Real Browser Agent (v22.7)

Pure Zig implementation - no shell scripts, no external dependencies:

# Build and run the demo
cd src/vibeec && zig build-exe demo_agent.zig && ./demo_agent

Output:

╔══════════════════════════════════════════════════════════════════╗
║           VIBEE AGENT v22.7 - REAL INTEGRATION DEMO              ║
╚══════════════════════════════════════════════════════════════════╝

[1/5] Discovering Chrome targets...
  Found target: ws://localhost:9222/devtools/page/...

[2/5] Connecting to Chrome CDP...
  Connected!

[3/5] Navigating to example.com...
  Navigation started!

[4/5] Getting page title...
  Title: Example Domain

[5/5] Asking LLM about the page...
  LLM Response: Example domain refers to specific subdomains...

╔══════════════════════════════════════════════════════════════════╗
║  ✓ Chrome CDP connection: WORKING                                ║
║  ✓ Page navigation: WORKING                                      ║
║  ✓ DOM evaluation: WORKING                                       ║
║  ✓ Ollama LLM integration: WORKING                               ║
╚══════════════════════════════════════════════════════════════════╝

Components (Pure Zig):

• websocket.zig - RFC 6455 WebSocket client
• http_client.zig - HTTP/1.1 client using std.http
• cdp_client.zig - Chrome DevTools Protocol
• real_agent.zig - Browser + LLM integration

Requirements:

• Chrome with --remote-debugging-port=9222
• Ollama running on port 11434

Documentation: docs/E2E_DEMO.md | docs/E2E_PIPELINE_GUIDE.md

📊 BitNet Benchmark Suite

Performance benchmarking for BitNet FPGA inference:

# Run benchmarks
python -m bitnet.benchmark --model model.bin

# With visualization
python -m bitnet.benchmark --model model.bin --plot --plot-dir plots/

# Specific benchmark type
python -m bitnet.benchmark --model model.bin --type latency --format json

Metrics:

Metric	Description
Latency	Mean, P50, P95, P99 inference time (ms)
Throughput	Tokens per second
Memory	Bandwidth (GB/s), peak usage

Output formats: JSON, CSV, Markdown, PNG/SVG plots

Documentation: BENCHMARK.md

📁 Project Structure

vibee-lang/
├── trinity-os/             # **Native Ternary OS (Web App)**
├── specs/tri/              # .vibee specifications (667+)
├── trinity/output/         # Generated Zig code (2000+)
│   └── fpga/               # **Generated Verilog HDL + Testbenches**
├── src/vibeec/             # Compiler source
│   ├── verilog_codegen.zig # **HLS / Verilog engine**
│   └── vibee_parser.zig    # Specification parser
├── bin/vibee               # CLI binary
├── docs/                   # Documentation
│   ├── TRINITY_PITCH_DECK.md # **Investor Deck**
│   ├── habr/               # Habr articles
│   ├── verdicts/           # TOXIC VERDICT reports
│   └── academic/           # Research papers
├── generated/multi/        # Multi-language output
└── archive/                # Historical files

📝 Specification Example

# specs/tri/my_feature.vibee
name: my_feature
version: "1.0.0"
language: zig
module: my_feature

types:
  User:
    fields:
      id: Int
      name: String
      active: Bool

behaviors:
  - name: create_user
    given: Valid user data
    when: Create called
    then: User created successfully

🔧 Commands

# Code Generation
vibee gen <spec.vibee>              # Generate Zig
vibee gen-multi <spec.vibee> all    # Generate 42 languages
vibee gen-all                       # Generate all specs (parallel)

# Testing
vibee test-all                      # Test all modules (parallel)
vibee chain                         # gen-all + test-all

# Utilities
vibee help                          # Show all commands
vibee eval "△ ∧ ○"                  # Ternary logic
vibee phi                           # Sacred constants
vibee serve                         # LLM inference server

🔌 FFI Modules

40 FFI modules for cross-language integration:

Category	Modules
Core	ffi_core, ffi_c_bindings
Primary	ffi_python, ffi_rust, ffi_go, ffi_wasm
Enterprise	ffi_java_jni, ffi_kotlin, ffi_swift
Scripting	ffi_ruby, ffi_php, ffi_lua, ffi_perl, ffi_r
Functional	ffi_haskell, ffi_ocaml, ffi_elixir, ffi_erlang
Systems	ffi_d, ffi_nim, ffi_crystal, ffi_julia

📊 Type Mapping

VIBEE Type	Zig	Python	Rust	Go
String	[]const u8	str	String	string
Int	i64	int	i64	int64
Float	f64	float	f64	float64
Bool	bool	bool	bool	bool
List<T>	[]const u8	List[Any]	Vec<T>	[]interface{}
Option<T>	?T	Optional[T]	Option<T>	*T

📚 Documentation

📖 Learn VIBEE

• VIBEE Language Guide - Complete language reference
• Documentation Index - All documentation
• Quickstart - Get started in 5 minutes

📰 Articles & Research

• Habr Article: Golden Key - Main article (RU)
• iGLA Documentation - Inference acceleration
• KOSCHEI System - Autonomous evolution
• Scientific Papers - Research references

🛠️ Development

• AGENTS.md - AI Agent Guidelines
• CLAUDE.md - Development Guidelines
• CONTRIBUTING.md - Contribution Guide

📈 Project Statistics

Metric	Value
Specifications (.vibee)	667+
Generated modules (.zig)	2000+
Supported languages	42
FFI modules	40
Tests passing	2000+
Lines of compiler code	20,000+

🤝 Contributing

1. Create .vibee specification in specs/tri/
2. Generate: vibee gen specs/tri/feature.vibee
3. Test: zig test trinity/output/feature.zig
4. Submit PR

See CONTRIBUTING.md for details.

📄 License

MIT License - See LICENSE

👤 Author

Dmitrii Vasilev

---

**φ² + 1/φ² = 3 | PHOENIX = 999 **