Home

PWE — Program the physical world in 4D

A Rust microkernel runtime + language for deterministic, distributed simulation of a 4D world — 3D space, plus time.

PWE is not another physics toy. It is a substrate: one authoritative world, one typed intermediate representation, and one language that models anything expressible as coupled differential or difference equations — gravity and collisions, chemical kinetics, population dynamics, electromagnetism, heat, sound, waves, robot arms, and machines that walk.

World Model → WIR → Domain IR → EIR → Interpreter / JIT / AOT → Runtime → CPU / GPU / NPU / Edge / Cloud

Determinism here is something you can prove: the interpreter is the semantic oracle, the JIT must agree with it byte-for-byte on every step, and the conformance suite enforces the frozen contract with zero skips.

Browse the wiki

Page	What it covers
Getting Started	Install, build, run the first world in under a minute.
The PWE Language	world, systems, rules, fields, modules, events, units.
Standard Library	std/ modules: forces, chemistry, thermal, robotics, …
Examples	The showcase demos and what each one demonstrates.
Determinism	Interpreter ≡ JIT, analytic conformance, snapshots, replay.
Architecture	Crate layout, the pipeline, the microkernel boundary.
The Frozen Contract	The full RFC set — design, frozen v0.2, extensions — and how to change it.
FAQ	Common questions, honest limits, roadmap.

The one-line pitch

The world is the single source of truth. Program it. Prove it. Watch it move.

Core rules

• World is the single authoritative source of truth. Model ≠ State.
• Entity = identity; Component = data; System = behavior.
• Authoritative mutation goes through a WorldTransaction; a mutable entity has exactly one authoritative owner.
• Physics, Render, Sensor, AI and Network are peer domains on one world — never independent worlds.
• Interpreter, JIT and AOT share EIR semantics; the interpreter is the semantic reference.

License

Apache-2.0. Copyright 2026 Open1s. https://github.com/open1s/qwe