Ferrocade

A 2D game engine with a Python API and a Rust core, rendering through wgpu. Planned platforms: Windows, macOS, and the web.

Early development. Phase 1 (a window and a centered sprite) works on Windows. See the engine spec for the design and roadmap.

Building from source

You need Rust (stable, with the MSVC toolchain on Windows), the Visual Studio C++ Build Tools, Python 3.13+, and uv.

uv venv; .venv\Scripts\Activate.ps1
uv pip install maturin pytest
maturin develop
python examples/01_centered_ship.py

The complete build and validation steps are in specs/001-centered-ship/quickstart.md.

Repository: https://github.com/pythonarcade/ferrocade

import ferrocade as fc


class Game(fc.Window):
    def __init__(self):
        super().__init__(800, 600, "Ferrocade", filter=fc.NEAREST)
        self.sprites = fc.SpriteList()
        self.sprites.append(fc.Sprite("assets/images/ship.png", center_x=400, center_y=300))

    def on_draw(self):
        self.clear()
        self.sprites.draw()


Game().run()

Repository layout

Path	Contents
docs/spec/	Engine spec: the living design document and decision log
docs/design/	In-depth subsystem designs
docs/research/	Spikes, benchmark results, engine comparisons
docs/guides/	User-facing guides (later)
crates/ferrocade/	Rust engine core
crates/ferrocade-py/	PyO3 bindings
python/ferrocade/	Python package
examples/	One example per roadmap phase
assets/	Images, sounds, fonts
tests/	Python API tests
benches/	Performance scenes
web/	Browser (WASM/Pyodide) build
tools/	Developer scripts
CLAUDE.md	Instructions for AI coding assistants