Marimo Lens

Let your agent see what you see.

Point to a chart, table, or other result in marimo, a reactive Python notebook. Lens gives your agent the selection, your note, and the code behind it, then brings the agent's work back into view for your review.

https://github.com/user-attachments/assets/e1975ba6-3087-485e-9360-43a99adc8795

• Point and ask. Mark a point or region on a chart, table, or other output. Lens keeps the mark, note, image, and relevant notebook context together.
• Follow the work. See where the agent is working and the result it brings into view.
• Review and continue. Reopen an addressed selection from History to refine the request against the current output.

#Try it

Open a notebook with uv, a Python environment and package manager:

uvx --with marimo-lens marimo edit notebook.py

Mount Lens in one notebook cell:

from marimo_lens import Lens

lens = Lens()
lens

Press Select, click a point or drag a region, and add a note. Keep the Lens cell mounted. Requires Python 3.10–3.14 and marimo 0.24.0 or newer.

Lens works with agents that can run code in the live notebook kernel, including marimo Pair. Follow the agent guide to connect one.

#Documentation

Getting started · Concepts · Selections · Custom labels · Python API · Troubleshooting

For development, start with Contributing and the architecture guide. Report a bug or follow the security policy for a vulnerability.

Apache 2.0. Inspired by Agentation.