swarmauri_tool_jupyterexportlatex 0.11.0.dev1

Swarmauri publication-export tool for converting Jupyter notebooks into LaTeX and optional PDF artifacts.

Swarmauri Jupyter Export LaTeX Tool

swarmauri_tool_jupyterexportlatex converts a notebook object into LaTeX with nbconvert.LatexExporter and can optionally generate a PDF artifact. It also supports custom LaTeX templates for publication-oriented workflows.

Why

• Produce LaTeX artifacts from notebooks for academic and report-generation workflows.
• Reuse custom templates for publication formatting.
• Optionally bridge notebook output into PDF-ready artifacts from a single tool surface.

Features

• Accepts notebook objects and normalizes them before export.
• Exports LaTeX with nbconvert.LatexExporter.
• Supports custom template directories and files.
• Optionally generates PDF output.
• Falls back to a dummy PDF artifact when xelatex is unavailable in the local environment.

FAQ

What input does this tool expect?

It expects a notebook object compatible with nbformat.from_dict, not a JSON string and not a notebook file path.

Does it always generate a PDF?

No. PDF generation happens only when to_pdf=True.

What happens if xelatex is missing?

The tool creates a dummy PDF file for testable fallback behavior instead of failing immediately.

Installation

uv add swarmauri_tool_jupyterexportlatex

pip install swarmauri_tool_jupyterexportlatex

Usage

from swarmauri_tool_jupyterexportlatex import JupyterExportLatexTool

notebook = {
    "cells": [{"cell_type": "code", "metadata": {}, "source": ["1 + 1"], "outputs": []}],
    "metadata": {},
    "nbformat": 4,
    "nbformat_minor": 5,
}

result = JupyterExportLatexTool()(
    notebook_node=notebook,
    to_pdf=False,
)

print(result["latex_content"][:200])

Examples

Export LaTeX only

result = JupyterExportLatexTool()(
    notebook_node=notebook,
    use_custom_template=False,
    to_pdf=False,
)

Export LaTeX and request PDF output

result = JupyterExportLatexTool()(
    notebook_node=notebook,
    to_pdf=True,
)

print(result.get("pdf_file_path"))

Related Packages

• swarmauri_tool_jupyterexporthtml
• swarmauri_tool_jupyterexportmarkdown
• swarmauri_tool_jupyterexportpython
• swarmauri_tool_jupyterexecuteandconvert
• swarmauri_tool_jupyterexecutenotebook

Foundational Swarmauri Packages

• swarmauri
• swarmauri_core
• swarmauri_base
• swarmauri_standard

More Documentation

• Swarmauri SDK repository
• nbconvert LaTeX export docs
• Jupyter documentation