startSetting up a working environment
The collection is made with a small set of tools. Most are written in Rust and published under Apache-2.0 or MIT. One command, make setup, installs the tools that a source repository needs, at pinned versions. Models run locally.
Required tools
| tool | purpose | install |
|---|---|---|
| git and a GitHub account | version control and hosting | git-scm.com |
| Python 3.13 or later | runs fgtools and gftools | python.org |
| fgtools | status, design checks, build, QA, build comparison, web proof, drafting evaluation | make setup |
| fontc 2.0.1 | compiles the sources | make setup |
| Fontspector 1.9.0 | checks the compiled fonts | make setup |
| Runebender | the font editor, also used by the design checks for measurement | github.com/fontgarden/runebender |
| Rust | builds the tracing tools and diffenator3 | rustup.rs |
make setup
In a source repository, make setup does three things:
- It creates the virtual environment
.venv. - It installs the pinned
requirements.txt. This includes fgtools, pinned to a commit, and gftools. - It runs
fgtools install-tools. This installs the fontc and Fontspector release binaries into.venv/bin, after a check of their SHA-256 checksums. It also compiles DesignBot from the commit that fgtools pins, with Cargo, into.venv/bin. The first compile takes about two minutes and needs thecargocommand from https://rustup.rs. Then it namesffmpegandrunebenderif they are missing.
Do not install the tools globally. requirements.in lists the direct dependencies. See The fgtools command.
Runebender
Runebender is the editor used on the collection. It reads and writes UFO and designspace sources directly. It is part of the Linebender project.
Runebender shows the mark color of each glyph, which this system uses as a grade. It labels each measurement with its decomposition into powers of two. See Glyph grades and The dyadic grid.
Install Runebender with Cargo. The command runebender must be on PATH:
cargo install --locked --git https://github.com/fontgarden/runebender runebender
Run the same command again to update it. make runebender opens the sources of a project in the editor. fgtools check-design and the MCP server of a coding agent use the same command.
fgtools check-design uses the Runebender binary for measurement. If the binary is not on PATH, set RUNEBENDER to its path.
Coding agents connect to the editor through MCP. An agent can read, measure, proof and propose. A project has a .mcp.json that starts runebender mcp --live, so that an agent tool that reads this file, for example OMP, gets the editor tools. A proposal shows in the open editor, and the designer applies or discards it there. See Proposals and grading.
Tools for a specimen image
These three tools turn a specimen image into purple drafts. See From a specimen image to drafts.
cargo install --git https://github.com/fontgarden/img2glyph
cargo install --git https://github.com/fontgarden/img2bez img2bez
cargo install --git https://github.com/fontgarden/img2ufo
img2glyphdivides a specimen image into one crop for each glyph.img2beztraces a raster into cubic outlines on the grid.img2ufotraces the labeled crops and writes them into a UFO, with placement, spacing and metrics.
Reference fonts
One shared collection of OFL fonts serves every comparison and measurement: the accent placement evaluation, proofs and checks. It is not a source of outlines.
export FONTGARDEN_REFERENCE_FONTS=~/reference-fonts
fgtools fetch-reference-fonts
The command downloads the trusted families from google/fonts. Each family goes to its own folder with its OFL.txt. The list is fontgarden/reference_fonts.toml in fgtools, with the reason for each family. The designer decides which families it holds. The first list has 9: Source Sans 3, Source Serif 4, IBM Plex Sans, Inter, Roboto, Noto Sans, Fira Sans, Work Sans and EB Garamond. Commands that take reference fonts use the collection by default.
Reference fonts of a project
Each font has its own references. A project names them in CONTEXT.md, each with the reason that it is a reference:
[reference_fonts.families]
heebo = "A Hebrew extension of Roboto: a plain sans for text."
notosanshebrew = "A Hebrew sans with full coverage of the marks."
A key is a directory name of google/fonts under ofl/, so the upstream of a family is https://github.com/google/fonts/tree/main/ofl/<name>. make reference-fonts copies the upright fonts and the OFL.txt of each family into reference-fonts/<name>/ of the project. Git ignores that folder. A family comes from the first place that has it:
- the shared collection of
FONTGARDEN_REFERENCE_FONTS; - a local clone of google/fonts that
FONTGARDEN_GOOGLE_FONTSnames; - a download from GitHub.
make proof-web and the proof view of Runebender read reference-fonts/. Runebender shows the families that cover the glyph, so a Hebrew glyph is shown beside the Hebrew references.
Optional tools
diffenator3, formake diff, which compares two builds.font-ml, which runs the task models locally.
Fontbakery and fontmake
Earlier Google Fonts documentation refers to Fontbakery. Fontspector replaced it. Do not add Fontbakery to a repository.
The fonts are built with fontc, the Rust compiler of Google Fonts that replaces fontmake. fgtools build --compiler fontmake builds with fontmake, and fgtools diff --fontmake compares the two compilers.