TorchFont

TorchFont logo

TorchFont is an unofficial library based on PyTorch for deep learning with vector fonts. It is not affiliated with or endorsed by the PyTorch project.

TorchFont is local-first: point CodepointDataset or GlyphIdDataset at a font directory or a repository checkout that already exists on disk, and TorchFont turns font files into lightweight glyph references. CodepointDataset indexes one sample per face and codepoint, while GlyphIdDataset indexes one sample per face and glyph, reaching ligatures and alternates no codepoint maps to. Load outlines explicitly with LoadGlyph in your transform pipeline when tensors are needed.

Installation

The package requires Python 3.10+ and PyTorch 2.5+.

Install TorchFont with uv:

uv add torchfont

Or with pip:

pip install torchfont

Quickstart

from torch.nn.utils.rnn import pad_sequence
from torch.utils.data import DataLoader

from torchfont import CodepointData, ElementType, Outline
from torchfont.datasets import CodepointDataset
from torchfont.transforms import LoadGlyph


def collate_fn(samples: list[CodepointData[Outline]]):
    outlines = [sample.data for sample in samples]
    return {
        "types": pad_sequence(
            [outline.types for outline in outlines],
            batch_first=True,
            padding_value=ElementType.PAD,
        ),
        "coords": pad_sequence(
            [outline.coords for outline in outlines], batch_first=True
        ),
    }


dataset = CodepointDataset(
    root="~/fonts",  # or "tests/fonts" in this repository
    patterns=("*.ttf",),
    codepoints=range(0x20, 0x7F),  # printable ASCII
    transform=LoadGlyph(),
)

loader = DataLoader(
    dataset,
    batch_size=8,
    shuffle=True,
    collate_fn=collate_fn,
)
batch = next(iter(loader))

print(batch["types"].shape)  # (8, L)
print(batch["coords"].shape)  # (8, L, 6)

What TorchFont Focuses On

local font directories and repository checkouts as the input boundary
local font indexing by codepoint or by glyph id, plus explicit outline loading through lightweight glyph references
torchvision.transforms.v2-style semantic pipelines for adapting glyph samples
PyTorch DataLoader integration through an explicit, customizable collate_fn

Manage font repository synchronization with Git or another tool, then point CodepointDataset(root=...) or GlyphIdDataset(root=...) at the resulting directory.

Citing TorchFont

If you find TorchFont useful in your work, please consider citing the following BibTeX entry:

@software{fujioka2025torchfont,
    author = {Fujioka, Takumu},
    title  = {{TorchFont}: A Machine Learning Library for Vector Fonts},
    year   = {2025},
    url    = {https://github.com/torchfont/torchfont}
}

Metadata

Release files for torchfont 0.13.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for torchfont 0.13.2
File	Size	Uploaded
torchfont-0.13.2.tar.gz	3.2 MB	Aug 26, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for torchfont 0.13.2
File	Interpreter	ABI	Platform	Reset
torchfont-0.13.2-cp314-cp314t-win_amd64.whl 3.0 MB Aug 26, 2026	CPython 3.14	CPython 3.14 free-threading	Windows x86-64	Details
torchfont-0.13.2-cp314-cp314t-manylinux_2_35_aarch64.whl 2.8 MB Aug 26, 2026	CPython 3.14	CPython 3.14 free-threading	Linux glibc 2.35+ ARM64	Details
torchfont-0.13.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.0 MB Aug 26, 2026	CPython 3.14	CPython 3.14 free-threading	Linux glibc 2.17+ x86-64	Details
torchfont-0.13.2-cp314-cp314t-macosx_11_0_arm64.whl 1.7 MB Aug 26, 2026	CPython 3.14	CPython 3.14 free-threading	macOS 11.0+ ARM64	Details
torchfont-0.13.2-cp310-abi3-win_amd64.whl 3.0 MB Aug 26, 2026	CPython 3.10	abi3	Windows x86-64	Details
torchfont-0.13.2-cp310-abi3-manylinux_2_35_aarch64.whl 2.8 MB Aug 26, 2026	CPython 3.10	abi3	Linux glibc 2.35+ ARM64	Details
torchfont-0.13.2-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.0 MB Aug 26, 2026	CPython 3.10	abi3	Linux glibc 2.17+ x86-64	Details
torchfont-0.13.2-cp310-abi3-macosx_11_0_arm64.whl 1.7 MB Aug 26, 2026	CPython 3.10	abi3	macOS 11.0+ ARM64	Details

Total release size: 22.1 MB

Release files / torchfont-0.13.2.tar.gz

Download URL	torchfont-0.13.2.tar.gz
Size	3.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`49d16631364f1fd4ec39e1c9bc450906d5bbc62c586fa2b121143c7cc3ecc115`
BLAKE2b-256 checksum How to use checksums	`e25df762d321ca68cbdc28de52d58aeeff1c4f078c94952bef731a7844ff7a72`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp314-cp314t-win_amd64.whl

Download URL	torchfont-0.13.2-cp314-cp314t-win_amd64.whl
Size	3.0 MB
Tags	CPython 3.14 CPython 3.14 free-threading Windows x86-64
SHA-256 checksum How to use checksums	`a66bc1b260157fce6e396c01a63a48b7b7f23c6b064692987719f47b78c8267b`
BLAKE2b-256 checksum How to use checksums	`3eda03a89372e7d73d31bcf2d29b41d4d1f3c178bc2da9a90f43838e1f465893`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp314-cp314t-manylinux_2_35_aarch64.whl

Download URL	torchfont-0.13.2-cp314-cp314t-manylinux_2_35_aarch64.whl
Size	2.8 MB
Tags	CPython 3.14 CPython 3.14 free-threading Linux glibc 2.35+ ARM64
SHA-256 checksum How to use checksums	`c7e997ec8dc5cf8c6530819cfc2e00f0b73427763e1fd49eb5b1eef7abc033ba`
BLAKE2b-256 checksum How to use checksums	`556eb4fd5bc43465f150291ce6908bcf43f6c56f3297c251c87c54d6dfd0c6c8`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	torchfont-0.13.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.0 MB
Tags	CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64
SHA-256 checksum How to use checksums	`5d492f262440b69fcaa18d93d433c5e47ee7cb1e6ae01fffcabb9f5416d34b54`
BLAKE2b-256 checksum How to use checksums	`3733cf6517177f3ab595c6610ea22de6d467a5935a12a9b9484ae1d7d05bd832`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp314-cp314t-macosx_11_0_arm64.whl

Download URL	torchfont-0.13.2-cp314-cp314t-macosx_11_0_arm64.whl
Size	1.7 MB
Tags	CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`9239285e57ee0893973c4732f56c18a2553b6b7d41f7a99b8684f9fb848cd38b`
BLAKE2b-256 checksum How to use checksums	`5127e6603950c0d4ab8e5165fdcedd094569c5336dab83981c3c3555ba61a659`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp310-abi3-win_amd64.whl

Download URL	torchfont-0.13.2-cp310-abi3-win_amd64.whl
Size	3.0 MB
Tags	CPython 3.10 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`5b731412303762e59ae5838a0fdfeb98fc8d2f1248f9989d25f89ab28c3908c0`
BLAKE2b-256 checksum How to use checksums	`a58a272ad41c071b2a0a0dbb427a0e38ef453eed71fb6467b184d48ce421e5d1`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp310-abi3-manylinux_2_35_aarch64.whl

Download URL	torchfont-0.13.2-cp310-abi3-manylinux_2_35_aarch64.whl
Size	2.8 MB
Tags	CPython 3.10 Linux glibc 2.35+ ARM64 abi3
SHA-256 checksum How to use checksums	`1a9694790d65ff3758ce0ca688c9d91e4ec7e6acfbaf07ec657ef61584c03e14`
BLAKE2b-256 checksum How to use checksums	`037dd8655f284d6db95d8477ed3c619cc3027b76b34f5dea103e24b5ea0dd804`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	torchfont-0.13.2-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.0 MB
Tags	CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum How to use checksums	`48185985d973308798eb951bdf3544a534d1b4585732f4f166e77fb9d9412cc3`
BLAKE2b-256 checksum How to use checksums	`fce61ee03e9879959653fda9d063eaa739d00321a0bb283ca82eebeed2ff3873`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / torchfont-0.13.2-cp310-abi3-macosx_11_0_arm64.whl

Download URL	torchfont-0.13.2-cp310-abi3-macosx_11_0_arm64.whl
Size	1.7 MB
Tags	CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`e80acfc9863ce95a2d174907fff9433f3a992d3a905da2fb2eba39e4cccec485`
BLAKE2b-256 checksum How to use checksums	`d7b62182b92edbd61faa9138585edce6df23bfb2c4a87936826f96bf5c62e39f`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`