Repository navigation
Home
Lume is a next-generation systems, polyglot interoperability, formal verification, autonomous AI, and post-quantum programming language engineered from first principles around a single invariant:
"No binary should ever be emitted unless its safety, memory discipline, worst-case execution bounds, and foreign-boundary contracts are mathematically proven by the compiler itself — with zero external C compilers, linkers, or SMT solvers."
Meet Lumi, our official sovereign chameleon mascot! Just as a chameleon adapts effortlessly to any environment while maintaining acute 360-degree vision, Lume's Universal Chameleon Polyglot Engine (lchameleon.src) bridges 9 major programming ecosystems (C/C++, Rust, Python DLPack, Node.js/WASM, Go, Java/JVM, C#/.NET, SQL, and OpenAPI/gRPC) under fail-closed QF_LIA arithmetic refinement proofs ([I0003]: unverified[T] -> verified[T]).
| Lumi — 3D Bioluminescent Chameleon Mascot | 9-Ecosystem Chameleon Polyglot Emblem | Official 3D App & Desktop GUI Icon | Vector Crest & Favicon |
|---|---|---|---|
![]() |
![]() |
||
docs/assets/lume-mascot.jpg |
docs/assets/lume-chameleon-emblem.jpg |
docs/assets/lume-icon.jpg (lume.ico) |
docs/assets/lume-mascot-badge.svg |
| Wiki Page | Description | Key Topics |
|---|---|---|
| Installation & Setup | One-line installation across Linux, macOS, Windows & WSL2 |
install.sh, install.ps1, Homebrew, GHCR Docker, lume self-prove
|
| Language Tour & Ergonomics | Expressive ML/Rust/Zig-inspired syntax & zero-boilerplate idioms |
fn, |> pipes, { r with f: v }, hardened f"...", Perceus own/mut
|
| Formal Verification & Prover | Embedded QF_LIA / QF_NIA / QF_BV / Separation Logic & WCET |
requires, ensures, law, @bound(cycles), @secret [C0009], lcert
|
| Universal Chameleon Engine | Zero-copy polyglot FFI & schema synthesis across 9 ecosystems |
lume chameleon, lume adapt, lume morph, [I0003] boundary proofs |
| 27 Compilation Targets | Direct machine-code, GPU, FPGA, WebAssembly & Quantum emission | ELF64, PE32+, Win64 GUI (x86_64-windows-gui), Mach-O, PTX, SPIR-V, QASM |
| Memory Saga & Atomic Compactor | How Lume achieved a 2,733x RAM reduction & 31.8x speedup |
.rodata interning, 63-bit tagged int + 7B SSO, 24B Cons, LZ1 arena |
| LumeLabs & Community Hub | Official R&D divisions, RFC governance, Projects & Discussions | 7 LumeLabs tracks, Project Roadmap, Good First Issues, Security policy |
| Guia Completo (PT-BR) | Documentacao oficial completa em Portugues do Brasil | Instalacao, sintaxe, provas formais QF_LIA, Camaleao Poliglota e Win64 GUI |
flowchart TB
SRC["Lume Source (.src / .lume)"] --> LEX["01_lexer + 02_parser\nHardened String Interpolation & Effect Rows"]
LEX --> PRV["03_prover (Embedded OmniProof v3)\nQF_LIA + QF_NIA + QF_BV + Separation Logic + WCET + @secret"]
PRV --> PER["Perceus Linear Reuse & 4-Tier Atomic Memory Compactor\n63-bit Tagged Int + 7B SSO + 24B Cons + LZ1 Cold Arena"]
PER --> CHM["Universal Chameleon Polyglot Engine (lchameleon.src)\n9 Ecosystems Verified under [I0003] Boundary Contracts"]
PER --> TGT["27 Native Targets (05_codegen + lasm + ltarget)\nELF64 / PE32+ / Win64 GUI / Mach-O / RISC-V / WASM / PTX / SPIR-V / RTL / Quantum"]
CHM --> CRT["Proof-Carrying Certificate (.lcert)\nSHA-256 + Ed25519 + Hybrid ML-DSA-65"]
TGT --> CRT
-
100% Self-Hosted Zero-C Steady State (
stage2 == stage3): Thelumeccompiler (compiler/stage1/lume/01_lexer.src..07_driver.src) andlasmnative assembler emit ELF64, PE32+, and Mach-O 64 binaries directly from Lume source without invokinggcc,clang,as, orld. -
Embedded OmniProof v3 Theorem Prover (
03_prover.src): Decides linear integer arithmetic (QF_LIA), nonlinear polynomial witnesses (QF_NIA), bitvectors (QF_BV), heap separation logic,@bound(cycles: N)WCET budgets ([V0002]), and@secretconstant-time side-channel freedom ([C0009]) in milliseconds. -
4-Tier Atomic Memory Compactor: Combines Perceus reference counting with compile-time
.rodatastring/list interning, 63-bit tagged integers, 7-byte inline SSO strings, compact24-byteConscells, and anLZ1cold-arena compactor (36.9 KBpeak heap across the entire self-hosted build). -
Universal Chameleon Polyglot, Singularity
$\Omega$ & Bayesian SPC Engine (lchameleon.src,68/68obligations): Synthesizes mathematically verified bidirectional bridges across 9 ecosystems (c_abi,rust_cdylib,python_capi,node_napi_wasm,go_cshared,java_jni,dotnet_pinvoke,sql_relational,openapi_rpc), plus the 2nd-Order Dynamical Transition Engine (OTE/ Singularity Boundary$\Omega$ :$\tau_{\max} = T_m/4$ ) and Empirical-Bayes Beta-Binomial SPC, Page's Tabular CUSUM, CPM Float &$k$ -Anonymous PAVA Isotonic Regression. -
27 Universal Compilation Targets (
ltarget.src), Cyber-Physical UFE/Subsea (77/77) & NetSentinel/Conduíte/Omega-Mesh (68/68): Including the Clean Generic Win64 Native GUI Backend (--target x86_64-windows-gui, standalone33,792-byte PE32+ GUI with declarative@ui-layout), 7-Layer Unified Field & Subsea/Marine Physics (lume unified-field/lume subsea: Catenary, VIV, Miner Fatigue, DNV Crane DAF, Bühlmann ZH-L16C, Well Kill, ASME B31G), and OT/HA Firewall + Sovereign Mesh/Raft/DHT (lume iec62443/lume conduite/lume omega-mesh). -
Claude Opus 5.5 + Sovereign Red-Team + Waves 1–3 Verified (
143/143): Every commit passestests/harness/claude_audit_gate.src(21Claude Opus 5.5 audit issues +64Red-Team Round 1/2/3 checks +58Waves 1/2/3 Cyber-Physical/Subsea/Conduíte/Mesh checks + 4-way differential fuzzer) andlume self-prove(557formal obligations,154unit tests,99manifest files).
Linux, macOS & WSL2:
curl -fsSL https://raw.githubusercontent.com/OmegaSoftDLL/lume/main/scripts/install.sh | shWindows (PowerShell):
irm https://raw.githubusercontent.com/OmegaSoftDLL/lume/main/scripts/install.ps1 | iexlume --version
lume self verify
lume self-prove
lume chameleonlaw conservation_of_funds(balance: int, amount: int) =
((balance - amount) + amount) == balance
@bound(cycles: 32)
pub fn safe_transfer(balance: int, amount: int) -> int / pure
requires balance >= 0 and amount >= 0 and amount <= balance
ensures result == balance - amount and result >= 0
=
balance - amount
print safe_transfer(1000, 250)
lume prove transfer.lume # Proves QF_LIA contracts + WCET @bound(cycles: 32)
lume build transfer.lume # Emits native standalone binary (Zero-C)
lume certify transfer.lume # Generates cryptographic .lcert proof bundlestage2 == stage3) · OmniProof-v4 (1,682 Proofs · 372 Tests · 122 Domains) · Signed Qualification Dossier PASS (106/106 Probes · 21/21 Gates · 0/9,618 Uncovered MC/DC) · 118 [C0011] Constant-Time Crypto Kernels · 9-Ecosystem Chameleon FFI ([I0003]) · 27 Targets · Licensed under Apache-2.0
- Home
- Getting Started
- Core Architecture & Assurance
- LumeLabs & Community
- Dossiers & Reference Manuals

