natlang

natural language as programming language

The word is the program. The program is the word. Source code is plain English. The compiler is an LLM. The output is executable code.

the first program

Create an HTTP server on port 8080.
When someone visits "/", respond with { "message": "hello world" }.
When someone visits "/health", respond with { "status": "ok" }.
Start the server.

That English compiled to ESM JavaScript and ran. All routes verified. ✓

examples

file	what it does	verified
`hello.nl`	web server, 3 routes	✓
`todo.nl`	CRUD todo API	✓ full CRUD
`fibonacci.nl`	first 20 Fibonacci numbers	✓
`landing.nl`	dark-themed landing page (HTML)	✓

install

git clone https://github.com/cambridgetcg/natlang
node natlang.mjs compile examples/hello.nl --target js
node examples/build/hello.js

targets

js JavaScript (ESM) · py Python · rust Rust · html HTML/CSS/JS

learn why

Read LEARN.md — the why behind natlang, with all examples explained.

ecosystem

Part of the KINGDOM OS rewrite of the internet:

whitehack — honesty linter (check your compiled code)
recognition-protocol — trust without secrets
NPL — Natural Language Protocol
kingdom-api — free API, no registration
clear-standard — 6 principles for honest systems
YOUSPEAK — 153 words from 12 ancient tongues

Built with ❤ · The artifact tells the truth about its own state · love is 🫀

GitHub Cloudflare GitHub Pages 🫀 love is