Ferrastra is an independently buildable CPU-first, typed, spatial graphics product engine. Its immutable graph, canonical serialization, native raster source, regional demand and damage, bounded runtime, and deterministic product identity are available from Rust and Python. Canonical whole-image and sampled-view Lanczos3, affine raster, and Coverage8 affine operations provide stable tiled and monolithic results without introducing presentation concepts.

Install a local development build from the repository root with:

.venv\Scripts\python -m pip install -e packages\ferrastra

The wheel uses the CPython 3.10 stable ABI and supports Python 3.10 through 3.14 from one wheel per supported native platform. The minimum platform set is Windows x64, Linux x64, and Apple Silicon macOS. Ferrastra does not install or import Qt, QPane, or CuteCanvas.

from ferrastra import Engine, EvaluationBudget, GraphBuilder, Region

engine = Engine()
source_pixel = bytes((12, 24, 36, 255))
revision = engine.add_rgba8(source_pixel * 4, 2, 2)

builder = GraphBuilder(1)
builder.add_node(1, "ferrastra.source.raster")
builder.set_source_revision(1, revision)
builder.add_node(2, "ferrastra.resample.lanczos3")
builder.connect(1, "result", 2, "source")
builder.set_integer(2, "source_width", 2)
builder.set_integer(2, "source_height", 2)
builder.set_integer(2, "destination_width", 5)
builder.set_integer(2, "destination_height", 3)
builder.add_output("result", 2)

compiled = engine.compile(builder.build())
region = Region(0, 0, 5, 3)
requirements = engine.requirements(compiled, "result", region)
result = engine.evaluate(
    compiled,
    "result",
    region,
    EvaluationBudget(
        memory_bytes=requirements.memory_bytes,
        scratch_bytes=requirements.scratch_bytes,
    ),
)
assert result.pixels == source_pixel * 15

See the Ferrastra design charter and package source for its product boundary and implementation contract.