Browse documentation

Start here

From Rust

How the supported profile, runtime and native boundary differ from a Cargo application.

Septa runs a supported subset of Rust through its own checked execution model. Structs, enums, pattern matching and ownership retain their documented Rust meaning. Effects, durable state and exact code identities become runtime concepts.

What changes

Native application Septa managed core
A process owns in-memory state A durable actor owns persisted state
Code calls available OS APIs Supported external operations cross typed effect boundaries
Cargo resolves a dependency graph Managed packages use exact content identities
Edits trigger native builds The installed runtime checks, lowers and executes supported source

The runtime still compiles internally. Building the runtime or a native host remains a separate Cargo workflow.

Effects, handlers and Septa explains effect checking and compares Septa with Unison and OCaml.

Concurrency, actors and async Rust explains how suspension differs from .await, what happens to actor state during a wait and where native async code fits.

Check the profile first

A program that compiles with rustc may use features Septa does not support. Check language and manifest support for the runtime command you plan to use. Read the profile before moving an existing crate into the core.

Use checked integers and exact decimals for core arithmetic. Code that depends on floating point, threads, ambient I/O or unsupported constructs needs an explicit native boundary.

Start with a library

Run the library tutorial. It creates reusable functions, a consuming application and tests. Then use the watch loop to see how edits become active.

For stateful code, run the counter. Separate processes will read the same actor state.

Use native Rust for integration

An ordinary Rust host can handle transport, authenticate incoming requests and use existing SDKs. It connects to Septa through public runtime interfaces and has its own build process and OS permissions. See native integration.

Search concepts, guides and reference.