Gavin JuddIndex

Build notes · 2 min read · October 2026

Build notes: Type Evidence

I asked for an elegant high-contrast serif and got novelty stencil fonts.

Type Evidence is a toolkit I made for finding and rendering existing fonts. What I actually wanted was to give capable AI agents real typefaces and real evidence to work with, plus the freedom to make much better typography decisions.

Why

AI agents pick fonts by name and reputation, but they can’t see the font and don’t know what’s actually on the machine. When a glyph is missing, the browser quietly swaps in a different font. So you end up with confident picks and pretty generic-looking results.

How it works

It started as a way to bring two big open font collections together in one harness that any AI could use. The first indexing pass went through 38,590 files and found 27,008 usable font faces, including 2,526 exact duplicates.

  • Every font is identified by the exact hash of its file, so “Garamond” always refers to one specific file.
  • HarfBuzz and FreeType render the text from those exact bytes. If a glyph is missing, the tool refuses to substitute a fallback. You get a PNG you can actually look at, plus the HTML and CSS to use it.
  • Unknown licensing stays “unknown.” Commercial fonts link to their providers, and the tool never serves their files.
  • You can run it as a command-line tool, a local MCP server for agents, and a browser explorer.

What went wrong

Searching by description was honestly the weak spot. I asked for an “elegant high contrast serif”, and Fatty Snax, Extra Virgin, Mondo Redondo and Offshore Banking Business came back as the top results: chunky, distressed or stencil-looking fonts. Searching with an image of Bodoni worked better, returning three readable serifs and one questionable outline face. That’s a big part of why the tool shows you the rendered font instead of trusting a search score.

A validity check that was sensitive to hinting was rejecting some valid fonts, including Kumar One. Checking them the same way they get rendered fixed that. Windows also broke a test over line endings, and indexing that many files is CPU-heavy.

Numbers

  • The October overhaul passed 349 Python tests and 12 explorer tests on Linux, macOS and Windows.
  • The directory covers 2,167 font families, with 1,940 open families (3,592 exact faces) indexed.
  • It now picks the fonts for KyberDex’s card renderer.

Source: github.com/gavinjudd/type-evidence · explorer