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 15, 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:
Latest release

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 15, 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.2.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.2-cp310-abi3-win_amd64.whl (549.6 kB view details)

Uploaded CPython 3.10+Windows x86-64

ferrastra-1.0.2-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.2-cp310-abi3-macosx_11_0_arm64.whl (619.7 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: ferrastra-1.0.2.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.2.tar.gz
Algorithm Hash digest
SHA256 b909eeaf814c563d8f58d37d2d848ef4c1523fb8c5dbe17696b39f690727861c
MD5 310d4449bc30f448b7d155529e21bf26
BLAKE2b-256 8c99ccbed65c2ed9542042f9e422d336ec9567c5ef0c3535235c92b6396c7350

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.2.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.2-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: ferrastra-1.0.2-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 549.6 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.2-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 91257d41bd8a4d88b6cf5c42eee610d640dd960ed03a4bae1def5b090ed31619
MD5 616369fd5d3559ddd6d219cd9c95ebdf
BLAKE2b-256 d3733d819da54745f3aa0157a7d9c8f108b7f3e7a8dba45025c1a762e0a972d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.2-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.2-cp310-abi3-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for ferrastra-1.0.2-cp310-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 5177757ce511771703eb5eb941533bd6003589256c7c5adf7e92381b74a03a2c
MD5 5ba2e09084268a284a7777adb83546c5
BLAKE2b-256 0dd04840bdee7d137851e14412b586c77ea60ab1f66f0922ff0c52ebdf4f313e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.2-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.2-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ferrastra-1.0.2-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b62fb18ef3993f45221d232bbcf20df9c6271a9d6c3de028ecb0f39ee0148b37
MD5 a0ae3dbda557237247eef135159e5811
BLAKE2b-256 1fb425a8b1155c54e05d70faeafe1bfc943eaf5359bebfb8f8e6960859bac78b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ferrastra-1.0.2-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

This release

1.0.2 This release

4 files

1.0.1

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