swarmauri_tool_jupyterexporthtml 0.11.0.dev1

Swarmauri HTML publishing tool for rendering Jupyter notebooks with nbconvert and optional inline presentation assets.

Swarmauri Jupyter Export HTML Tool

swarmauri_tool_jupyterexporthtml converts Jupyter notebook JSON into HTML using nbconvert.HTMLExporter, with optional template selection and inline CSS or JavaScript injection.

Why

• Publish notebooks as web-ready HTML artifacts.
• Apply presentation-specific HTML templates without rewriting notebook content.
• Add inline CSS or JavaScript for branded notebook presentation workflows.

Features

• Parses notebook JSON into a NotebookNode.
• Exports notebook content through nbconvert.HTMLExporter.
• Supports optional template_file overrides.
• Can inject inline CSS into the document head.
• Can inject inline JavaScript before the closing body tag.

FAQ

What input does this tool accept?

It expects a JSON string representing the notebook, not a file path and not a Python dictionary.

Does it write an HTML file?

No. It returns the generated HTML string in exported_html.

When should I use extra CSS or extra JS?

Use them when the exported notebook needs lightweight presentation customization without managing a full custom exporter package.

Installation

uv add swarmauri_tool_jupyterexporthtml

pip install swarmauri_tool_jupyterexporthtml

Usage

from swarmauri_tool_jupyterexporthtml import JupyterExportHtmlTool

notebook_json = """
{
  "cells": [{"cell_type": "markdown", "metadata": {}, "source": ["# Demo"]}],
  "metadata": {},
  "nbformat": 4,
  "nbformat_minor": 5
}
"""

tool = JupyterExportHtmlTool()
result = tool(notebook_json=notebook_json)

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

Examples

Export HTML with custom CSS

result = JupyterExportHtmlTool()(
    notebook_json=notebook_json,
    extra_css="body { max-width: 960px; margin: 0 auto; }",
)

html = result["exported_html"]

Export HTML with custom JavaScript

result = JupyterExportHtmlTool()(
    notebook_json=notebook_json,
    extra_js="console.log('Notebook rendered');",
)

Related Packages

• swarmauri_tool_jupyterexecuteandconvert
• swarmauri_tool_jupyterexportmarkdown
• swarmauri_tool_jupyterexportlatex
• swarmauri_tool_jupyterexportpython
• swarmauri_tool_jupyterexecutenotebook

Foundational Swarmauri Packages

• swarmauri
• swarmauri_core
• swarmauri_base
• swarmauri_standard

More Documentation

• Swarmauri SDK repository
• nbconvert HTMLExporter docs
• Jupyter documentation