Metadata-Version: 2.4
Name: marimo-studio
Version: 0.2.0
Summary: Custom views for Marimo notebooks
Author: Péter Ferenc Gyarmati
Author-email: Péter Ferenc Gyarmati <dev.petergy@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Dist: agent-plugins>=0.2.4
Requires-Dist: click>=8.2
Requires-Dist: htpy>=26.5.1
Requires-Dist: marimo==0.25.0
Requires-Dist: marimo-export>=0.1.0
Requires-Dist: markupsafe>=3
Requires-Dist: packaging>=25
Requires-Dist: tomli>=2 ; python_full_version < '3.11'
Requires-Dist: tomlkit>=0.14
Requires-Dist: tree-sitter>=0.25.2
Requires-Dist: tree-sitter-javascript>=0.25.0
Requires-Dist: watchdog>=6.0.0
Requires-Dist: deno>=2.9.5 ; extra == 'deno'
Requires-Dist: marimo-lens>=0.2.2 ; extra == 'lens'
Requires-Dist: marimo-studio[deno,lens] ; extra == 'recommended'
Requires-Python: >=3.10, <3.15
Project-URL: Homepage, https://marimo-team.github.io/marimo-studio/
Project-URL: Documentation, https://marimo-team.github.io/marimo-studio/
Project-URL: Documentation Index, https://marimo-team.github.io/marimo-studio/llms.txt
Project-URL: Repository, https://github.com/marimo-team/marimo-studio
Project-URL: Issues, https://github.com/marimo-team/marimo-studio/issues
Provides-Extra: deno
Provides-Extra: lens
Provides-Extra: recommended
Description-Content-Type: text/markdown

# Marimo Studio

Marimo Studio turns one [marimo](https://marimo.io/) notebook into reports,
apps, and presentations. Keep data, computation, and controls in Python.
Shape each view for its audience, by hand or with a coding agent.

Marimo Studio is experimental. Pin Studio and third-party view providers in
saved projects.

## Get started

```console
uvx --with marimo-studio marimo edit analysis.py --sandbox
```

Add a displayable cell, then click **Add view** in the Studio toolbar. Save the
notebook if prompted and choose a name and starter. Notebook and Preview open
side by side. Use the source action to edit the view's files, or work through
Marimo's agent sidebar.

Saving view source rebuilds Preview. A failed build retains the last successful
view. Follow the [quickstart](https://marimo-team.github.io/marimo-studio/guide/getting-started)
for a complete first view. [uv](https://docs.astral.sh/uv/) supplies `uvx` and
resolves the notebook's declared dependencies with `--sandbox`.

## For agents

Read the version-matched briefing shipped with Studio through
[Agent Plugins](https://github.com/peter-gy/agent-plugins), which prints the
instructions a Python package ships for coding agents:

```console
uvx --with marimo-studio agent-plugins read marimo-studio
```

From the notebook's Python environment:

```python
import marimo_studio.agent

help(marimo_studio.agent)
```

The briefing covers inspecting, creating, editing, building, and verifying
views. Follow the [agent guide](https://marimo-team.github.io/marimo-studio/guide/coding-agents)
to connect your agent and work with optional Marimo Lens feedback.

## Run or export a view

Serve a live **Python** app, run Python in the **Browser** with Pyodide, or publish
**Prepared** results as a static site. Browser delivery includes notebook source.
Prepared delivery includes the exported results and finite input states.

[Run or export a view](https://marimo-team.github.io/marimo-studio/guide/run-and-share)
explains the delivery choice and what visitors receive.

## Documentation

[Guide](https://marimo-team.github.io/marimo-studio/guide/) ·
[Examples](https://marimo-team.github.io/marimo-studio/examples/) ·
[Reference](https://marimo-team.github.io/marimo-studio/reference/) ·
[Compatibility](https://marimo-team.github.io/marimo-studio/reference/compatibility) ·
[Troubleshooting](https://marimo-team.github.io/marimo-studio/guide/troubleshooting)

Report bugs through [GitHub Issues](https://github.com/marimo-team/marimo-studio/issues).
See the [security policy](https://github.com/marimo-team/marimo-studio/blob/main/SECURITY.md)
for private reports.

## License

[Apache License 2.0](https://github.com/marimo-team/marimo-studio/blob/main/LICENSE).
