✦ Lume

The Deterministic Natural-Language Programming Language — where English is code, voice is a compiler, and AI is an optional fallback.

let answer = ask gpt4 "Summarize this article"
show answer

📚 42-paper canonical research corpus — Core language, DAIGS governance framework, 6 physics substrates, and 22 domain verticals. Full collection: lume-daigs-ecosystem on Zenodo

Quick Start

# Install
npm install -g @lume/compiler

# Run your first program
echo 'show "Hello from Lume!"' > hello.lume
lume run hello.lume

# Or use the REPL
lume repl

5 Minutes to Your First Program

1. Variables & Output

let name = "World"
let count = 42
show "Hello {name}, the answer is {count}"

2. Functions

to greet(name: text) -> text:
    return "Hello, " + name + "!"

show greet("Lume")

3. Control Flow

for i in 1 to 10:
    if i % 2 == 0:
        show i + " is even"

4. Native LLM Keywords

let summary = ask gpt4 "Summarize: " + article
let ideas = think claude "Generate 5 product names for: " + description
show summary

5. English Mode — Write code in plain English

mode: english

get the user profile from the database
if the user is not verified
    send an email to the user
show the dashboard

6. Verify — Natural Language Assertions

let count = 10
let users = ["alice", "bob"]

verify count is 10
verify users is not empty
verify count is greater than 5

Features

| Feature | Description | |---------|-------------| | 🤖 Optional LLM Fallback | ask, think, generate are keywords — no SDK needed | | 🗣️ English Mode | Write code in plain English (154+ patterns) | | 🌍 Multilingual | Write in any human language — Spanish, Japanese, Hindi... | | 🎤 Voice-to-Code | Speak your code, Lume compiles it | | 🔄 Self-Sustaining Runtime | Programs monitor, heal, optimize, and evolve themselves | | 🔒 Security Layer | 11 threat categories, Guardian scanner, raw block protection | | 📦 Full-Stack Generator | lume create "an ecommerce store" scaffolds entire apps | | 🔍 Reverse Mode | lume explain file.js — any code explained in English | | ✅ Verify Keyword | Natural language assertions: verify count is 10 | | 🚀 Deploy Engine | First-class deployment: deploy to render from "main" | | ⚙️ Config Language | Type-safe config as code — replaces YAML/TOML/JSON | | 🎓 Education Mode | Beginner-tuned tolerance: draw a big red circle | | ♿ Accessibility | Complete eyes-free programming with auditory feedback |

CLI Commands

lume run <file>          Run a .lume file
lume build <file>        Compile to JavaScript
lume repl                Interactive REPL
lume create <desc>       Generate a full-stack app
lume explain <file>      Explain any code in English
lume ast <file>          Show Abstract Syntax Tree
lume tokens <file>       Show token stream
lume fmt <file>          Auto-format source
lume lint <file>         Lint for errors and style
lume compile <file>      Compile to native binary (via Bun)
lume diff <a> <b>        AST-level diff between files
lume watch <file>        Watch and re-run on changes
lume test <file>         Run inline tests
lume listen              Voice-to-code (browser mic)
lume bundle <file>       Bundle for distribution
lume verify <file>       Verify compile lock
lume deploy <target>     Deploy to render
lume heal status         View self-healing status

Examples

lume run examples/hello.lume        # Hello World
lume run examples/fizzbuzz.lume     # Classic FizzBuzz
lume run examples/calculator.lume   # Calculator with error handling
lume run examples/todo.lume         # Todo list app
lume run examples/discount.lume     # Pattern matching

Project Stats

• CI tested on Node 18, 20, and 22 on every push
• 154+ patterns in the English Mode resolver
• 16.5K+ lines of source code
• 38 example programs
• 20+ CLI commands including estimate (cost analysis) and --strict-english (deterministic mode)
• 13 milestones complete
• 5 vertical applications — DevOps, Testing, Config, Education, Accessibility
• MIT licensed

Documentation

• Getting Started — Your first Lume program in 5 minutes
• English Mode — Writing code in plain English (154 patterns)
• CLI Reference — All commands and flags
• API Reference — Programmatic usage of @lume/compiler
• Voice-to-Code — Speak your code
• Self-Sustaining Runtime — How programs heal themselves
• Security — The Guardian security layer
• Vertical Applications — Deploy, Verify, Config, Education, Accessibility

Lume-OS Integration

Lume is the foundation language of the Trust Layer ecosystem. As a Lume-native project, it is registered with Lume Cortex — the deterministic meta-operating system.

| Property | Value | |---|---| | Cortex Bridge | cortex-bridge.js | | Build | Lume-native (no Lume-V wrapper needed) | | Ecosystem | trust-layer-42 (42 apps · 42 papers) | | Cortex Endpoint | lume-cortex.onrender.com |

Part of the Trust Layer Ecosystem

Lume is part of the Trust Layer ecosystem — connected through shared identity, shared design, and shared philosophy.

Built with ❤️ by DarkWave Studios · lume-lang.org · MIT License

Intellectual Property

This software is part of the Trust Layer ecosystem by DarkWave Studios LLC.

Patent Pending:

• U.S. Pat. App. No. 64/032,339 — Lume-V: Deterministic Autonomous Infrastructure Governance Engine
• U.S. Pat. App. No. 64/047,512 — Lume Core: Deterministic Natural-Language Programming Language
• U.S. Pat. App. No. 64/047,467 — Axiom: Deterministic Zero-Assumption AI System
• U.S. Pat. App. No. 64/047,496 — Lume-X: Deterministic Multi-Agent Cognition Substrate
• U.S. Pat. App. No. 64/047,536 — Synthetic Organisms: Deterministic Self-Governing Cyber-Physical Constructs

© 2026 DarkWave Studios LLC. All rights reserved.