0xProto-368K-GGUF

pszemraj/0xProto-368K-GGUF

0xProto-368K-GGUF is a image-to-text model from pszemraj. Use it when you need a caption or text from an image. It is set up for gguf. The card lists the license as ofl-1.1.

A GGUF v3 encoding of 0xProto v2.502, a monospace programming font. Contains lossless vector outlines (bezier control points, contour topology, on-curve flags) and a precomputed 32px F32 bitmap cache for all 719 mappe…

Downloads · 30 days

12% of all-time downloads

All-time downloads

230

Public

Repo size

1.7 MB

Likes

Public

Hugging Face

Repo makeup

Click a slice to open those files.

.gguf1.7 MB · 99%

At a glance

Task: Image-to-Text
Library: gguf
License: ofl-1.1
Access: Public
Created: May 22, 2026
Updated: May 22, 2026
SHA: 9cad0f0e

Model card

From the Hugging Face model README

0xProto Regular - GGUF

This is a font, not a language model. general.architecture is font.

Artifact


File	`0xProto-Regular-v2.502-F32.gguf`
Format	GGUF v3, little-endian, alignment=32
Size	1.65 MB
Tensors	2,847
Metadata entries	18
Source font	0xProto-Regular.ttf (206 KB)
License	SIL Open Font License 1.1

Tensor layout

Each codepoint with a non-empty glyph gets up to four tensors:

Tensor	Shape	DType	Description
`outline.U+XXXX.points`	`[n_points, 2]`	I32	Bezier control point coordinates in font units (1000 UPM)
`outline.U+XXXX.flags`	`[n_points]`	I32	1 = on-curve anchor, 0 = off-curve quadratic control point
`outline.U+XXXX.contours`	`[n_contours]`	I32	Endpoint index of each closed contour
`bitmap.U+XXXX`	`[h, w]`	F32	Rasterized grayscale bitmap, normalized [0.0, 1.0], tight-cropped

Three global metric tensors cover all 719 codepoints in sorted order:

Tensor	Shape	DType	Description
`metrics.advance_widths`	`[719]`	I32	Horizontal advance per codepoint (font units)
`metrics.lsb`	`[719]`	I32	Left side bearing per codepoint (font units)
`metrics.bboxes`	`[719, 4]`	I32	Bounding box [xMin, yMin, xMax, yMax] per codepoint

The font.codepoint_labels metadata array maps index position to U+XXXX label for the metric tensors.

Metadata

general.architecture    = font
general.name            = 0xProto Regular
general.file_type       = 0 (ALL_F32)
font.family             = 0xProto
font.style              = Regular
font.weight             = 400
font.units_per_em       = 1000
font.is_monospace       = 1.0
font.total_codepoints   = 719
font.render_size_px     = 32
font.postscript_name    = 0xProto-Regular
font.author             = 0xType Project Authors
font.url                = https://0xtype.dev/

Example: reading a glyph outline

# Any GGUF reader works. This is raw struct parsing for zero dependencies.
import numpy as np

points = read_tensor("outline.U+0041.points")  # shape (23, 2)
flags = read_tensor("outline.U+0041.flags")  # shape (23,)
contours = read_tensor("outline.U+0041.contours")  # shape (2,)

# points[:,0] = x, points[:,1] = y in font units (1000 UPM)
# flags[i] = 1 means on-curve, 0 means off-curve quadratic handle
# contours = [15, 22] means outer path ends at index 15, counter at 22

Why

GGUF is a self-describing, mmap-compatible, aligned binary container with typed KV metadata and named N-dimensional tensors. The spec constrains the container syntax but not the application schema. Font glyph outlines are variable-length 2D coordinate arrays with per-point flags and per-glyph contour topology - data that maps to named tensors without any encoding tricks.

The outline tensors are lossless. You could reconstruct the font from this file.

Conversion

Produced by font_to_gguf.py (included in this repo) using fontTools for TTF parsing and Pillow for bitmap rasterization.

pip install fonttools pillow numpy
python font_to_gguf.py

Credit

0xProto is designed by 0xType and released under the SIL Open Font License 1.1.

Task: Image-to-Text
Library: gguf
License: ofl-1.1
Created: May 22, 2026
Updated: May 22, 2026