安装

Entelechy 目前需要从源码构建。仓库是私有的（Fynn-3D/entelechy），你需要有访问权限。

准备

Rust 1.93 或更高版本（工作区 rust-version = "1.93"，edition 2024）。用 rustup 安装：
终端窗口
```
rustup update stable
rustc --version   # 应 ≥ 1.93
```
Git，以及能访问私有仓库的 GitHub 账号。
可选：要构建窗口程序 entelechy-player，Linux 上需要 pkg-config 与 libudev 开发包（例如 Debian/Ubuntu 的 pkg-config libudev-dev）；GPU 后端需要可用的 Metal / Vulkan / DX12 适配器。

git clone https://github.com/Fynn-3D/entelechy.git
cd entelechy
cargo build --release

cargo build --release 会把所有程序放进 target/release/：

程序	作用
`entelechy`	命令行：`new`、`check`、`run`、`render`、`replay`、`serve`、`trace`、`graph`、`bench`…
`entelechy-player`	在窗口中打开场景并实时热更新
`entelechy-import` / `entelechy-export`	导入 glTF、音频、MIDI、SVG、字体；导出为 GLB、WAV、MIDI、字体
`libentelechy_ffi`	C ABI 动态库，见嵌入与桥接

只想要命令行，可以只构建它（更快，也不需要 libudev）：

cargo build --release -p entelechy

entelechy version

应输出类似：

entelechy = 0.0.2-rc.3
entelechy.api = 1
entelechy.language = 3
entelechy.ir = 1
entelechy.package = 1

再运行第一个示例：

entelechy run examples/grayscale/scene.esn --out gray.png
entelechy replay examples/grayscale/tests/grayscale.replay

evaluated in 1.24ms: executed [gray+source, blocks], reused 0 -> gray.png
examples/grayscale/tests/grayscale.replay: ok (1 frames, 5 checks)

cargo build --workspace
cargo test --workspace

Blender、Godot、headless Chrome 和 C 编译器的桥接测试在相应工具缺失时会自动跳过。仓库自己的完整验证流程是 cargo xtask verify（见参与贡献）。