Two Foundations. One Philosophy.
Choose your base. Both share the same recipe system and tools.
LevitateOS
glibc / systemd / GNU
Maximum software compatibility. If it runs on Linux, it runs here. Systemd handles services, timers, and boot.
- Broadest package compatibility
- Comprehensive service management
- Rocky 10 RPMs for dependencies
- Familiar to most Linux users
AcornOS
musl / OpenRC / busybox
Smaller binaries, faster boot, simpler init. For those who prefer knowing exactly what's running on their system.
- Leaner compiled binaries
- Straightforward init scripts
- Alpine Linux PKGs for dependencies
- Less complexity under the hood
Recipes, Not Repositories
Instead of apt or dnf, LevitateOS uses recipe.
A recipe is an elaborate .rhai script that describes how to acquire, build, and install a package. Rhai is a safe, sandboxed scripting language embedded in Rust — readable in seconds, impossible to hide malicious code in.
// recipes/ripgrep.rhai
let ctx = #{
name: "ripgrep",
version: "14.1.0",
repo: "BurntSushi/ripgrep",
};
fn is_acquired(ctx) {
is_file(join_path(BUILD_DIR, "rg/Cargo.toml"))
}
fn acquire(ctx) {
let tarball = github_download_release(
ctx.repo, ctx.version, "*.tar.gz"
);
extract(tarball, BUILD_DIR);
}
fn build(ctx) {
shell_in(BUILD_DIR + "/rg",
"cargo build --release");
}
fn install(ctx) {
let bin = BUILD_DIR + "/rg/target/release/rg";
shell("install -Dm755 " + bin + " $OUT/usr/bin/rg");
}Everything a package does, in one readable file.
$ recipe llm "create a recipe for htop"
Drafting recipe for htop...
// recipes/htop.rhai
let ctx = #{
name: "htop",
version: "3.3.0",
repo: "htop-dev/htop",
};
fn is_acquired(ctx) {
is_file(join_path(BUILD_DIR, "htop/configure.ac"))
}
fn acquire(ctx) {
let tarball = github_download_release(
ctx.repo, ctx.version, "*.tar.xz"
);
extract(tarball, BUILD_DIR);
}
fn build(ctx) {
let src = BUILD_DIR + "/htop";
shell_in(src, "./autogen.sh && ./configure && make");
}
fn install(ctx) {
shell_in(BUILD_DIR + "/htop", "make install DESTDIR=$OUT");
}
Recipe saved. Review and run: recipe install htopLocal Recipe Assistant
Writing recipes is straightforward, but you shouldn't have to do it from scratch.
The recipe assistant is a local LLM that drafts recipes by reading upstream documentation. It runs on your machine — no cloud, no telemetry. You review the output, make adjustments, and run it.
Embedded Documentation
LevitateOS installs manually. The documentation lives alongside your terminal in a tmux pane — no browser tabs, no context switching.
The install guide appears right next to your shell:
- Code on the left
- Documentation on the right
- Context exactly when you need it
Ready to Build?
LevitateOS is for engineers who want to understand their system — and have the tools to shape it.
A clean base. Readable recipes. Local AI assistance.
Your system, your way.
Standing on the Shoulders of Giants
For the blueprint on user-controlled distributions and manual installation.
For stable, battle-tested RPM packages that we extract and repackage.
For proving that musl and simplicity can power production systems.
For pioneering dependency management and reproducible builds.
For USE flags and the philosophy of compile-time customization.
For demonstrating image-based atomicity on the desktop.
For AI-assisted development that accelerated this project.
For SmolLM3, the local LLM powering the recipe assistant.
For a compiler that catches memory bugs before they happen.