Skip to content

Use Calkit TinyTeX image - #15

Merged
petebachant merged 5 commits into
mainfrom
use-calkit-tinytex-image
Sep 21, 2026
Merged

petebachant merged 5 commits into
mainfrom
use-calkit-tinytex-image

Conversation

@petebachant

Copy link
Copy Markdown
Member

From Claude:

Switches the tex environment from texlive/texlive:latest-full to ghcr.io/calkit/latex:0.1.0, which is about 991 MB against roughly 9 GB.

This is what makes the quickstart quick. Creating a project from this template takes about 25 seconds, but the first calkit run has to pull the TeX image before it can build the paper, so the image size is most of the wall clock a new user experiences.

The new image is TinyTeX plus a curated set of packages, built from images/latex in the calkit repo and published from a latex-image/v0.1.0 release. It carries the classes for Elsevier, APS, IEEE, ACM, ACS, MNRAS, Springer LNCS and AMS, plus latexdiff, and runs as the invoking user so output isn't owned by root.

Because this only changes image: and keeps kind: docker, it works with every released version of Calkit. No minimum version is needed.

🤖 Generated with Claude Code

@petebachant

Copy link
Copy Markdown
Member Author

From Claude: Updated to ghcr.io/calkit/latex:0.1.1, which adds sectsty — this template's paper uses it, so 0.1.0 couldn't build the paper at all.

Also dropped the committed environment locks. The pipeline run on this branch left them inconsistent: the amd64 lock described TeX Live with no digest while the arm64 lock described the new image. That happens because released Calkit pulls a lock's recorded digest even when the environment now names a different image, so changing image: alone kept building with the old one. Deleting the locks avoids that entirely, since with nothing recorded the configured tag is what gets pulled, and they are regenerated on the next run.

The underlying bug is fixed in calkit/calkit#1695, so once that ships, changing an image will re-lock on its own.

@petebachant
petebachant merged commit 7ea06a6 into main Sep 21, 2026
1 check passed
@petebachant
petebachant deleted the use-calkit-tinytex-image branch September 21, 2026 13:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant