tex.gaato.net

tex.gaato.net provides endpoints to render LaTeX strings as SVG or PNG images.

Runtime

• Cloudflare Workers compatible runtime
• TypeScript
• MathJax v4.1.0
• optional Node.js container runtime for PNG rendering

Setup

pnpm install

This project enforces dependency build-script policy in pnpm-workspace.yaml. If a new dependency requires install scripts, explicitly review and allow it there.

CI

pnpm install --frozen-lockfile
pnpm build

Local run (Node server)

pnpm dev:node

This starts a local HTTP server on 127.0.0.1:8080 with the compatibility endpoints used by coderunbot.

Local run (Workers)

pnpm dev

This builds TypeScript and starts wrangler dev using wrangler.toml.

Deploy (Workers)

pnpm deploy

Before first deploy, authenticate once:

pnpm dlx wrangler login

GitHub Actions deploy

The repository includes deploy workflow.

Set the following repository secrets before using it:

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID

GitHub Actions container publish

The repository also includes container workflow.

Set the following repository secret before using it:

• GHCR_PAT

When running the Node server directly, use LISTEN_HOST and PORT to override the bind address.

Endpoints

POST /render

Renders a LaTeX string as an SVG image.

POST /render/svg

Alias for /render.

POST /render/png

Renders a LaTeX string as a PNG image. This endpoint is available from the Node server / container runtime and is the compatibility endpoint currently used by coderunbot.

Request Parameters

Parameter	Type	Description
latex	string	LaTeX string to be rendered

Response

• 200 OK
  • image/svg+xml: SVG image
• 400 Bad Request
  • text/plain: Error message if the LaTeX string is missing or if there's a LaTeX syntax error
• 500 Internal Server Error
  • text/plain: Error message if any other error occurs