Installation
Build
entelechy from source with Rust 1.93+. Start →Entelechy documentation
Host provides reality · Kernel defines law · Graph defines structure · AI is the creator
Welcome to the official documentation of Entelechy, a runtime written in Rust: a program is small, pure Kernels (.ent) and a scene graph (.esn) saying how they relate. The world keeps running while a person or an AI replaces its laws and structure safely — a wrong change is refused and the running version stays alive.
These docs describe v0.0.2-rc.3. The full contents are on the left; search is at the top; 中/EN and the theme are at the top right.
IntroductionWhat Entelechy is, why it exists, its four roles.
ArchitectureHost → ABI → IR → Kernel Runtime → Graph Runtime, and the crate layers.
StatusVerified platforms, known issues, what is next.
FAQCommon questions about the language, platforms, performance and AI.
Getting started
Section titled “Getting started”First Kernel
An
.ent where every pixel works out its own color. Start →First scene
Wire Kernels into a graph, add a param, write a replay test. Start →
Live swap
--watch and the Player: change it while it runs. Start →Tutorial: grayscale
examples/grayscale, step by step. Start →Example gallery
The repository’s 33 runnable examples. Browse →
Manual
Section titled “Manual”Kernels & .entrequires, ports, params, functions, expressions.
Types & FieldsImage, Grid, Rows, Volume; layout and binding.
Execution modesmap, reduction, scan, scatter, prefix, group.
Scenes & .esnuse, input, param, node, wires and devices.
Graph & stateFusion, the plan, <~ state, migration, times, async.
Hot swap & validationPrepare, generations, atomic publication, history, snapshots.
BackendsThe cpu reference, jit, gpu, best, and placement.
Capabilities & securityrequires, --grant, --allow, and what a served scene reaches.
Agent protocolJSON lines, 24 operations, compose, a real session.
Command line17 subcommands and the common flags.
Class reference
Section titled “Class reference”Reference overviewGenerated from entelechy help --json, a running session and rustdoc: 268 pages.
Protocol · SessionMethods, signals, envelope — one class, as in Godot.
Builtins114 functions, a page per kind.
Packagesimage, raster, physics, text… 19 standard packages.
Community
Section titled “Community”ContributingReading order, branches and commits, cargo xtask verify.
Design decisions32 rulings on why it is this way.
About these docsHow they were generated, what was verified, known gaps.