Run marimo, directly from VS Code.
Note: This extension requires marimo to be installed on your system: pip install marimo
.
Check out the marimo documentation at https://docs.marimo.io/.
VS Code's embedded browser does not support all native browser features. If you encounter any issues, try opening marimo in your default browser instead. For example, the embedded browser will not support PDF render, audio recording, video recording, and some copy/paste operations.
This extension includes an experimental feature to run marimo in VSCode's native notebook interface. This feature lets you use VSCode editors and extensions for writing code while the outputs and visualizations are rendered in a view-only marimo editor. This marimo editor displays outputs, console logs, and UI elements to interact with.
This feature is experimental and may have some limitations. Some known limitations are:
marimo
, numpy
, and more) you may be required to include a pyproject.toml
file at the root of the workspace. marimo's editor gets around this by default but unfortunately, the VSCode's native notebook does not.You can configure the extension using the following settings:
marimo.browserType
: Browser to open marimo app (system
or embedded
, default: embedded
)marimo.port
: Default port for marimo server (default: 2718
)marimo.enableToken
: Enable token authentication (default: false
)marimo.tokenPassword
: Token password (default: empty)marimo.showTerminal
: Open the terminal when the server starts (default: false
)marimo.debug
: Enable debug logging (default: false
)marimo.pythonPath
: Path to python executable (default: empty)marimo.marimoPath
: Path to marimo executable (default: marimo
)