TorchFont
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
DataLoaderintegration through an explicit, customizablecollate_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}
}
1 maintainer
Metadata
1 maintainer
Release files for torchfont 0.13.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| torchfont-0.13.1.tar.gz | 3.2 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| torchfont-0.13.1-cp314-cp314t-win_amd64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows x86-64 | Details |
| torchfont-0.13.1-cp314-cp314t-manylinux_2_35_aarch64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.35+ ARM64 | Details |
| torchfont-0.13.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.17+ x86-64 | Details |
| torchfont-0.13.1-cp314-cp314t-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 11.0+ ARM64 | Details |
| torchfont-0.13.1-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| torchfont-0.13.1-cp310-abi3-manylinux_2_35_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.35+ ARM64 | Details |
| torchfont-0.13.1-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| torchfont-0.13.1-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 22.0 MB
Release files / torchfont-0.13.1.tar.gz
| Download URL | torchfont-0.13.1.tar.gz |
|---|---|
| Size | 3.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d3a6a7dd6d6a357572765db18fdc9f38a12e9ceb92f7a87f3f97dd7688975bd
|
|
BLAKE2b-256 checksum How to use checksums |
44dfd8e57a8af4b695b38235390dfaf180695062a0f0f32198fc96c2171aa221
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp314-cp314t-win_amd64.whl
| Download URL | torchfont-0.13.1-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 |
2e28fc92b4b380c5cc7eeeafb4b629b9a5252748bd44d7644c533e43a3c5a4c4
|
|
BLAKE2b-256 checksum How to use checksums |
705117b529901f3a7a9599c1f88543179cccbf257dd61cae439e25a639a055a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp314-cp314t-manylinux_2_35_aarch64.whl
| Download URL | torchfont-0.13.1-cp314-cp314t-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.35+ ARM64 |
|
SHA-256 checksum How to use checksums |
e6d6fbfa35147a345a2d33c6bce017554eb3a0a6c2c0d5ba4039d793643c330f
|
|
BLAKE2b-256 checksum How to use checksums |
57d39ffd4822ba9b88c0a19f545e18e791e765abaf5504f37e9a054607564586
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | torchfont-0.13.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
d0131019213457f81aacdeeae290cb352a63f7c85f6dca3b75b24ee5b2b1056f
|
|
BLAKE2b-256 checksum How to use checksums |
983867bb448971858644b99dabfba71bacba111c996372d5081340d0a4321b31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | torchfont-0.13.1-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 |
9eeeb46775b8447735eafb626aba16ca59c840895ce8c6f20305084e48e84b04
|
|
BLAKE2b-256 checksum How to use checksums |
8843c5339b8555b07839598fd5ec7c02468e3b21a45299964de3a16c33bc23ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp310-abi3-win_amd64.whl
| Download URL | torchfont-0.13.1-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1f202138717d3ddffcae1177372f6bd65a1445e76c27aff135abae366642cc1a
|
|
BLAKE2b-256 checksum How to use checksums |
2dfb2898c70f66a0a5ec0188278bb25d360767768a54d8e7230e047025e88efc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp310-abi3-manylinux_2_35_aarch64.whl
| Download URL | torchfont-0.13.1-cp310-abi3-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.10 Linux glibc 2.35+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c6f0c817820c16e520bce25918b858eda9e02a0457302c31494a423a84d2de53
|
|
BLAKE2b-256 checksum How to use checksums |
e2ff01263d97def6ae5133f75381fc62117b7ed96088d3027ab04c193b926c69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | torchfont-0.13.1-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 |
2c5dc9602d8106759dad2dc434addb8413fc7bae41d72f25f164c0ec2948acf6
|
|
BLAKE2b-256 checksum How to use checksums |
1179238fe628095cbb84958c0ab70f17fd773330d0c4175051179112bb3a0e8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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.1-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | torchfont-0.13.1-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 |
44561aa56682778b14feff53846943c201c82b578a9b94e759136bd267295c33
|
|
BLAKE2b-256 checksum How to use checksums |
c38084ead230d267ef3161421bd490044fab8ed34dd4273280685be9390f2b57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
|
