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.
cargo install ezu-cliThat puts an ezu binary on your PATH. Check it:
ezu --helpEvery command is listed in the CLI reference.
cargo add ezuThe umbrella crate re-exports the workspace behind feature flags:
[dependencies]ezu = { version = "0.6", features = ["parallel"] }parallel pulls in Rayon and enables Evaluator::render_parallel. Leave it off
for wasm. See use from Rust and the per-crate map in
crates.
npm install @reearth/ezuThe package ships browser, Node, and workerd builds, in scalar and SIMD
variants, and exposes them through conditional exports — your bundler picks the
right one. See use in the browser.
Example styles and brushes
Section titled “Example styles and brushes”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:
git clone https://github.com/reearth/ezu && cd ezuls 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.
Editor support
Section titled “Editor support”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.jsonregenerates it locally, including any custom ops you registered.ezu serveserves it at/schemas/ezu-style.jsonand 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.