Repository navigation
JETCARP 0.4.0
The first public release.
What JETCARP 0.4.0 does
- Tilings. Squares, hexagons and triangles, all eleven Archimedean tilings, the 1,248 k-uniform
tilings up to k = 6, the 81 isohedral tile types, tiles you draw yourself, and the aperiodic
Penrose (kites and darts, and rhombs), hat and spectre tilings, built on exact patches. - Automata. Life and the Life-like rules, Generations, Larger than Life, elementary rules on
squares and hexagons, Langton's ant and the turmites, WireWorld, Greenberg–Hastings, the cyclic
and rock-paper-scissors rules, hodgepodge, sandpiles, Lenia and other continuous rules, JACA
(Jimmie Rodgers's annihilating two-sided Life), layered rules, Margolus block rules, rule tables
and von Neumann's 29-state automaton. Several can run at once, on shared or separate cell fields. - The app. A Quick Start menu of examples, an editor for worlds, tiles and unit cells, thirty
palettes and your own, pictures and animations, and screensaver mode. - On the desktop. A background host that runs scenes as a live wallpaper (Windows, macOS, and
GNOME through its own extension), on the GNOME lock screen, as the system's screen saver (Windows
and macOS), or as a still picture; see Wallpapers. - One program for every front end.
jetcarpopens the app, and its subcommands are the command
line, the background host (jetcarp host) and an MCP server for AI assistants (jetcarp mcp).
Rhai scripts run worlds and parallel rule sweeps. All of them call one layer of 79 named
operations, each with JSON Schemas for its input and output (jetcarp api list). - AI assistants.
jetcarp mcpgives an assistant such as Claude Code or Claude Desktop 21 tools
over those operations (worlds, scripts, the library, searches, media and packs), the app's
displays when it drives the app, and this book as resources, within folder and time limits; see
Driving JETCARP from an AI assistant. - Searches. Nine search strategies (soup hunts on the plane and on bounded grids, a rule census,
ants and turmites, movers on aperiodic tilings, large sandpiles, collisions, an evolutionary glider
search, and an exploratory search over tilings, rule families and rules) run as resumable jobs
whose results don't depend on the thread count; see Search methods. - A verified pattern library. Every catalogued pattern is verified exactly, named by a content
id that any program can recompute, and pinned to its tiling's geometry and its rule family's
meaning, so a change to either is caught; see Library format. - Packs. Format 1.0 for sharing data: signed, content-addressed stores of Parquet tables and
canonical JSON that other tools read without JETCARP, checked hash by hash and id by id on import;
ratings go in only with each rater's consent. See Packs and
Pack format. - A starter pack beside the program: 79 Quick Start entries that Jimmie Rodgers picked (36 from
the atlas of an exploratory search, 18 spaceships, 8 oscillators, 8 ant and turmite highways, 7
sandpile identities and 2 hat gliders), with the 26 pattern records and 8 ant records they show.
The 63 built-in examples picked with them are featured in the Quick Start menu. See
The starter pack. - Reproducibility. Every run is a scene that replays bit for bit to a recorded state hash, and
every picture JETCARP saves carries its scene; see Reproducibility. - Installing. Archives for Linux (x86_64 and ARM, glibc 2.28 or newer), Windows and macOS (Apple
silicon and Intel), installers that check every download, Python wheels for pipx, uv and pip, a
Homebrew tap, a Scoop bucket and crates.io, with a starter pack beside the program; see
Installing JETCARP. - First-run setup. On its first launch the app asks what JETCARP is for, in five profiles
(Desktop art, Explorer, Researcher, Everything, Blank slate), and sets it up: a data folder of your
choosing for big libraries, the starter pack and packs of your own imported, a Quick Start build
that searches for so many minutes and adds its best runs to the Quick Start, and the live
wallpaper and screen saver offered, never turned on unasked. The work runs as background jobs;
jetcarp setupdoes the same in a terminal. See First run and setup. - No network, no telemetry. JETCARP makes no network connections; see
SECURITY.md. - This book, with a page on the history and credits of every automaton and tiling.
JETCARP grew out of CART, a private prototype Jimmie Rodgers built in early November 2026, and was
reworked for release in a new repository with a fresh history; see
How JETCARP was made.
Installing
Linux and macOS:
curl -LsSf https://github.com/jprodgers/jetcarp/releases/download/v0.4.0/jetcarp-installer.sh | shWindows (PowerShell): save the installer, then run it.
Invoke-WebRequest https://github.com/jprodgers/jetcarp/releases/download/v0.4.0/jetcarp-installer.ps1 -OutFile jetcarp-installer.ps1
powershell -ExecutionPolicy Bypass -File .\jetcarp-installer.ps1Or: pipx install jetcarp, uv tool install jetcarp or pip install jetcarp; brew tap jprodgers/jetcarp and brew install jetcarp; scoop bucket add jetcarp https://github.com/jprodgers/scoop-jetcarp and scoop install jetcarp; or cargo install jetcarp.
Every way to install, and what to know on each system, is in
Installing JETCARP. Each file's SHA-256 is in
SHA256SUMS.