Skip to main content
Back to Features

Guide baseline: v0.9.11

LaTeX and MathML

Scan LaTeX source, convert supported equations to MathML, and review bounded source remediation.

Source remains the primary output

The processor detects inline and display mathematics and common equation environments, creates MathML and ARIA labels, and checks metadata, language, figures, tables, equation labels, links, lists and colour-only cues. Remediation writes .tex source by default in the direct library path. A successful conversion does not establish the intended spoken mathematics.

Package and output limits

Custom macros, unsupported packages, TikZ, chemistry and physics notation, multi-file projects and malformed source can require manual work. Recognition of a construct is not complete package support. A PDF sent to the LaTeX route follows the PDF pipeline; it does not reconstruct TeX source.

The route accepts .tex, .txt, .md and .pdf. The source upload limit uses MAX_FILE_SIZE_CODE (10 MiB by default); PDF input uses MAX_FILE_SIZE_PDF (50 MiB by default). Content validation still applies.

Optional HTML and PDF

The API can request tex, html and pdf, but conversions depend on installed executables and can return no file. HTML prefers LaTeXML; PDF prefers LuaLaTeX, with HTML/Playwright and more limited pdflatex fallbacks. Diff the source, compile in a restricted environment, and review each generated format independently. Preserve included files and project dependencies.

Check the spoken expression

For the expression below, an illustrative label is “negative b plus or minus the square root of b squared minus four a c, all divided by two a.” The expression contains no equality. Check the generated label against the author’s intended grouping and test MathML with the intended browser and assistive technology.

\frac{-b \pm \sqrt{b^2 - 4ac}}{2a}

Authenticated API usage

Use your deployment URL and an authorized API key. The localhost URL below is for a locally running API.

curl --fail --silent --show-error \
  -H "Authorization: Bearer $AELIRA_API_KEY" \
  -F "[email protected]" \
  "http://localhost:8000/education/latex/scan?use_ollama=false"

This multipart request delegates to /education/latex/convert and returns a scan_id. Poll GET /education/scans/{scan_id}/progress, then GET /education/scans/{scan_id}. The v0.9.11 scan latex CLI sends JSON although this route requires a file upload; use this HTTP path for this release.

API authentication, lifecycle and errors

Evidence and review

This guide describes released Core source; availability in a hosted deployment depends on its release and configuration. Review output before publishing it.

Read the v0.9.11 source and limits

Review findings, saved output and verification evidence