Skip to content

Install

ezu needs a Rust toolchain to build from source (MSRV 1.89) and nothing at all to run — no system graphics libraries, no GPU driver, no browser.

Terminal window
cargo install ezu-cli

That puts an ezu binary on your PATH. Check it:

Terminal window
ezu --help

Every command is listed in the CLI reference.

Nothing is bundled into the library: a style names every brush, font, and image it uses through its sources block. The painterly example styles reference CC0 brushes by relative file: path, so render those from a checkout:

Terminal window
git clone https://github.com/reearth/ezu && cd ezu
ls crates/ezu/examples/styles/
# atlas.json photo-pop.json poi-field.json stained-glass.json
# hillshade.json pencil-sketch.json risograph.json topo.json
# watercolor.json brushes/

Only pencil-sketch.json and watercolor.json need the checkout, for their brushes. Every other example style — hillshade.json, topo.json, atlas.json (its font is a URL), or anything ezu translate emits — renders straight from a URL with no checkout.

Point your editor’s JSON language server at the style schema and you get completion and as-you-type validation for all 82 ops:

  • ezu-style.schema.json — generated from the same registry the renderer uses.
  • ezu schema --out ezu-style.schema.json regenerates it locally, including any custom ops you registered.
  • ezu serve serves it at /schemas/ezu-style.json and the built-in editor consumes it directly.

Map renders on this site are made fromOpenStreetMap data viaProtomaps (© OpenStreetMap contributors), elevation from Re:Earth Terrain,Mapterhorn andEGM2008 (NGA), and aerial imagery from GSI Japan(© 国土地理院). The painterly styles use CC0 brushes byDavid Revoy.