External dependencies

External dependencies

By default, quarto-marimo creates a sandboxed Python environment with uv. To add a package for one document, declare it in the document frontmatter under pyproject.

---
pyproject: |
  requires-python = ">=3.11"
  dependencies = [
    "marimo>=0.23.1",
    "wigglystuff",
  ]
---

After that, you can import the package normally inside marimo cells. If the package exposes an anywidget, wrap it with mo.ui.anywidget so marimo can keep the UI reactive in Quarto output.

Example: `wigglystuff.Slider2D`

---
title: External dependencies
header: |-
  # Copyright 2026 Marimo. All rights reserved
pyproject: |
    requires-python = ">=3.11"
    dependencies = [
        "marimo>=0.23.1",
        "wigglystuff",
    ]
---

# External dependencies

By default, `quarto-marimo` creates a sandboxed Python environment with `uv`.
To add a package for one document, declare it in the document frontmatter
under `pyproject`.

```yaml
---
pyproject: |
  requires-python = ">=3.11"
  dependencies = [
    "marimo>=0.23.1",
    "wigglystuff",
  ]
---
```

After that, you can import the package normally inside marimo cells. If the
package exposes an anywidget, wrap it with `mo.ui.anywidget` so marimo
can keep the UI reactive in Quarto output.

## Example: `wigglystuff.Slider2D`

```{python .marimo}
import marimo as mo
from wigglystuff import Slider2D

widget = mo.ui.anywidget(
    Slider2D(
        width=320,
        height=320,
        x_bounds=(-2.0, 2.0),
        y_bounds=(-1.0, 1.5),
    )
)

widget
```

```{python .marimo}
mo.callout(
    f"x = {widget.x:.3f}, y = {widget.y:.3f}; bounds {widget.x_bounds} / {widget.y_bounds}"
)
```