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.0.tar.gz (109.4 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.0-cp310-abi3-win_amd64.whl (549.3 kB view details)

Uploaded CPython 3.10+Windows x86-64

ferrastra-1.0.0-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.0-cp310-abi3-macosx_11_0_arm64.whl (619.9 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: ferrastra-1.0.0.tar.gz
  • Upload date:
  • Size: 109.4 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.0.tar.gz
Algorithm Hash digest
SHA256 8e617cc3077d7f4c1ded1b1ac8baf04294b57653618d5fbf7798fb66f39c4a6d
MD5 337b96cafdf4d0e471b3ba396b2fa348
BLAKE2b-256 9c61b12f9d4e59c953e39aae365e815e80e2d07b71a5675cf8500af20e965b51

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: ferrastra-1.0.0-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 549.3 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.0-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 d446874305ee06b75ba07e6b770b34db63456d3697c8c2aad8d4b1a78384c4d9
MD5 13693902daf8c1249b7f34e709ed5ca0
BLAKE2b-256 6815088e47ee365d81521de4545f89ffec748e63bb1bf2b4eb51cf5c41fbfe3d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ferrastra-1.0.0-cp310-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 d9eff1ae4082c55c9e2ba9f027f59041c50effac0715eee367e2a2ebcf01d6cf
MD5 9aee730b3fff516e6d542390bc2abf59
BLAKE2b-256 eaa29327e3f94864aa01fc6416956c301d9a99340b745f7613c80b00a792376b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ferrastra-1.0.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4ccb41a0e44bbbce9905d44716b25e70818dccbd8887fe89fb1ff1f8a4f08257
MD5 12eef5308c210ffa4f85d787f3ef54af
BLAKE2b-256 cc02f5eb9d19b63873a77bf20a0fe422770a60cce790180bceeffde62f8a93a9

See more details on using hashes here.

Provenance

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

1.0.1

4 files

This release

1.0.0 This release

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