Let your agent see what you see.
marimo-lens connects a point or region on a rendered marimo notebook output to its producing cells, relevant notebook context, and an annotated image when capture succeeds. A live notebook agent can inspect the request, show its activity, and return results for review. Reopen an addressed selection from History to continue the analysis.
Install and mount
In a project managed by uv:
uv add marimo-lens
uv run marimo edit notebook.py
Requires Python 3.10–3.14 and marimo 0.24.0 or newer. Mount Lens in one notebook cell and keep it displayed:
from marimo_lens import Lens
lens = Lens()
lens
Press Select, click a point or drag a region, then add a note.
Custom pages can publish Lens client metadata for notebook inputs, labels, rendering references, and image context. Native Marimo outputs remain selectable through their existing output cells.
Connect an agent
Lens works with agents that can execute Python in the live notebook kernel, including marimo Pair. The package includes the matching agent instructions and registers its Lens capability with marimo. Follow Connect an agent for setup and the inspection, verification, and review workflow.
Documentation
Getting started · Concepts · Python API · Compatibility · Data and trust
Source, issue tracking, and contributor documentation live in the marimo-lens repository.
Release files for marimo-lens 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| marimo_lens-0.1.0.tar.gz | 184.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marimo_lens-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 382.5 kB
Release files / marimo_lens-0.1.0.tar.gz
| Download URL | marimo_lens-0.1.0.tar.gz |
|---|---|
| Size | 184.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be64953dde662fb81a1035f7a3a9a75daa5869b3128728da713d5b9e4307fd39
|
|
BLAKE2b-256 checksum How to use checksums |
24c8cebad22f76e7bcf66f5c3da651bcae3374bedb17949210286ab8b85d9795
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / marimo_lens-0.1.0-py3-none-any.whl
| Download URL | marimo_lens-0.1.0-py3-none-any.whl |
|---|---|
| Size | 197.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5a128c886879dbd7460e507ed75ce3e8d9b4dc277946a57da4dc3c61819d7ab
|
|
BLAKE2b-256 checksum How to use checksums |
99b78f5af4040f798368d37a613593ceb8e8f039635bb3cf174d996c5d6adf3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
