Ferrastra — oxidized image processing

Phase 3 Test status Python 3.10+ Rust 1.93.1 GPL-3.0-or-later license

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.

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ArtificialSweetener from gravatar.com ArtificialSweetener

Credits

Author: Artificial Sweetener

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

GPL-3.0-or-later
View SPDX License List

Requires

Python <3.15, >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ferrastra-1.0.1.tar.gz (109.5 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ferrastra-1.0.1-cp310-abi3-win_amd64.whl (549.4 kB view details)

Uploaded CPython 3.10+Windows x86-64

ferrastra-1.0.1-cp310-abi3-manylinux_2_34_x86_64.whl (2.6 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.34+ x86-64

ferrastra-1.0.1-cp310-abi3-macosx_11_0_arm64.whl (619.8 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file ferrastra-1.0.1.tar.gz.

File metadata

  • Download URL: ferrastra-1.0.1.tar.gz
  • Upload date:
  • Size: 109.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ferrastra-1.0.1.tar.gz
Algorithm Hash digest
SHA256 15cbca08a9cce71c9e5c50057623655b732b9d90becfbea7346313ce3638cfd2
MD5 1ad41e688e7fac16ea7d5e2838c3d95b
BLAKE2b-256 1e02b073008626923d8d8bc0f11851bb1ddbca7b594c79fbf50ccf90d8d7cb08

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.1.tar.gz:

Publisher: publish.yml on Artificial-Sweetener/CuteCanvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ferrastra-1.0.1-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: ferrastra-1.0.1-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 549.4 kB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ferrastra-1.0.1-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 436b9665cb33da14480603e121054867052c29bde2d42118c83780b080e3f9a2
MD5 4ea6ccc8cfeb25d96406785ca248c19b
BLAKE2b-256 31fa6ba8cfedb74bc46d312dec85158cbb1b4b0fcc85812e1febb20950a3cd3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.1-cp310-abi3-win_amd64.whl:

Publisher: publish.yml on Artificial-Sweetener/CuteCanvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ferrastra-1.0.1-cp310-abi3-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for ferrastra-1.0.1-cp310-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 fe29c538ccba90d6381986c1ac2ca25050d04fc7939e2e8ea1f6bac59d507ae2
MD5 9dc87f2755942d6ed570098922a03445
BLAKE2b-256 8fc40b1864ec5902be1b4f4aab77e52b279a0dc2faaf64c3e54df7f49df9f6ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.1-cp310-abi3-manylinux_2_34_x86_64.whl:

Publisher: publish.yml on Artificial-Sweetener/CuteCanvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ferrastra-1.0.1-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ferrastra-1.0.1-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 405cef49f23999029544086a263045d7d2c857024b8254d8f1ef7365ec44b100
MD5 33d796b0cc276784926ceca2cff647a9
BLAKE2b-256 ce78dd55f07268a25fe112302bb6154a6c010fd8de317db4a5c8c537238f4058

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.1-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on Artificial-Sweetener/CuteCanvas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.2

4 files

This release

1.0.1 This release

4 files

1.0.0

4 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page