Skip to content

marimo-team/vscode-marimo

Repository files navigation

vscode marimo

Visual Studio Marketplace Version

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/.

Features

  • 🚀 Launch marimo from VS Code, in both "edit mode" and "run mode".
  • 💻 View the terminal output of marimo directly in VS Code.
  • 🌐 View the marimo browser window directly in VS Code or in your default browser.
  • 📓 Convert Jupyter notebooks to marimo notebooks.

Known Issues

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, or video recording.

Extension Settings

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.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)