📖 VSE Documentation

Complete reference for Vector Speed Emissions v3.1

Table of Contents

  1. Installation
  2. Quick Start
  3. Command Reference
  4. C → .v Transpilation Guide
  5. Optimization Reports
  6. Feature Guides
  7. Troubleshooting
  8. Licensing

1. Installation

macOS

cp ~/Desktop/VSE/vse /usr/local/bin/vse
chmod +x /usr/local/bin/vse
vse --help

Requirements: Python 3.9+, clang (Xcode CLT)

Ubuntu / Debian

sudo cp vse /usr/local/bin/vse
sudo chmod +x /usr/local/bin/vse
sudo apt-get install python3 clang build-essential
vse --help

Windows

# Install Python 3.9+ and LLVM/clang
# Copy vse to your PATH
python vse --help

Android (Termux)

pkg install python clang
python3 vse encode input.c

2. Quick Start

Create a C file:

#include <stdio.h>
int add(int a, int b) { return a + b; }
int main() { printf("%d\n", add(2,3)); return 0; }

Then:

vse encode hello.c      # Transpile C → .v → native binary
vse run hello.c         # Transpile → compile → execute
vse report hello.c      # Optimization analysis (free, always)
vse bench hello.c       # Benchmark C vs VSE
vse watch hello.c       # Auto-recompile on save

3. Command Reference

CommandDescription
vse encode input.cTranspile C → .v + .vse package + compile to native binary
vse run input.cFull pipeline: transpile → compile → execute
vse bench input.cBenchmark clang -O2 vs VSE (binary size + runtime)
vse report input.cOptimization analysis — always free, no limits
vse watch input.cPoll file every 500ms, recompile on change
vse cacheShow build cache stats (SHA-256 keyed)
vse cache clearClear all cached builds
vse decode in.vse --key KEYDecode .vse → original C (licensed)

4. C → .v Transpilation

C Pattern.v Output
int x = 5;x := 5
int a = 0, b = 1;a := 0
b := 1
float pi = 3.14;pi := 3.14
int arr[10];arr := [0; 10]
return x;return x
if (x > 0) { }if x > 0 { }
for (int i=0; i<n; i++)i := 0; for i < n { ... i = i + 1 }
while (i < n) { }for i < n { }
i++ / i--i = i + 1 / i = i - 1
x += 5;x = x + 5
printf("...")console_write("...")

Type Mapping

C Type.v TypeSize
inti324B
floatf324B
doublef648B
chari81B
boolbool1B
int32_ti324B
size_ti648B

5. Optimization Reports

CategoryCountsMeaning
Loopsfor, whileSIMD vectorization candidates
Arraysarr[i]Batch processing candidates
Mathsqrt, sin, cos...GPU-accelerable operations
I/Oprintf, fopenVUCE compressible bandwidth
Allocmalloc, callocMemory optimization targets
Branchesif statementsBranch prediction candidates

6. Feature Guides

Watch Mode

vse watch myprogram.c --run

Polls file every 500ms. Debounces 300ms after last write. --run executes binary after successful compile. Ctrl+C to stop.

Build Cache

vse cache          # Show entries + total size
vse cache clear    # Wipe all cached builds

Location: ~/.vse_cache/. SHA-256 content-hash keyed. Clear after VSE updates or OS compiler changes.

Benchmarking

vse bench myprogram.c --runs 10

Measures: binary size (clang vs VSE), runtime (average of N runs), speedup percentage. VSE averages 19.9% faster across 7 benchmark programs.

Cluster Compilation

python3 tools/cluster_orchestrator.py compile myprogram.v

Distributes across 9 nodes: macOS ARM64, Ubuntu x86_64, Debian 12, Windows x64, Linux ARM64, Android aarch64. 106 total cores, 10GbE interconnect.

7. Troubleshooting

ErrorFix
"V compiler not found"Ensure ~/fractal_resonance_grand/v exists
"No C file generated"Check .v syntax: python3 v check file.v
Linker errors (cblas_*)Add -framework Accelerate (automatic in v2.1+)
"ADB offline"adb connect 192.168.50.212:5555
"SSH offline"Wake node: wakeonlan <MAC>
Cache stalevse cache clear then re-encode

8. Licensing

⭐ Full-Use License

For professional developers shipping production code.

🏢 Enterprise License

For teams and organizations. Everything in Full-Use plus:

📧 sickbastered@icloud.com — All license inquiries