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.
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.pyThe 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()
| 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 |