metaframe-widget 0.1.0

anywidget for embedding metaframe URLs in Jupyter and marimo notebooks

metaframe-widget

An anywidget for embedding metaframe URLs in Jupyter and marimo notebooks.

Install

pip install metaframe-widget

With environment extras:

pip install "metaframe-widget[jupyter]"   # includes jupyterlab
pip install "metaframe-widget[marimo]"    # includes marimo

Quick start

Jupyter

from metaframe_widget import MetaframeWidget

w = MetaframeWidget(url="https://js.mtfm.io/#?js=...", height="300px")
w

marimo

import marimo as mo
from metaframe_widget import MetaframeWidget

w = MetaframeWidget(url="https://js.mtfm.io/#?js=...", height="300px")
mo.ui.anywidget(w)

Create from inline JavaScript

w = MetaframeWidget.from_code("""
  setOutput("result", getInput("data") * 2);
""", height="300px")

API reference

Parameter	Type	Default	Description
url	str	""	Full metaframe URL (including hash params)
inputs	dict	{}	Dict of inputs to push to the metaframe
outputs	dict	{}	Dict of outputs received from the metaframe (read-only)
width	str	"100%"	CSS width for the widget container
height	str	"400px"	CSS height for the widget container
allow	str	""	iframe allow attribute (e.g. "camera; microphone")

Methods

• set_inputs(d) — merge a dict into current inputs
• set_input(key, value) — set a single input key
• on_outputs_change(callback) — register a callback for output changes
• from_code(js_code, **kwargs) — class method to create a widget from inline JS
• pipe_to(target, output_key, input_key=None) — connect an output to another widget's input

Piping widgets

source = MetaframeWidget(url="...")
sink = MetaframeWidget(url="...")
source.pipe_to(sink, output_key="result", input_key="data")

Links

• GitHub
• Jupyter examples
• marimo examples