Skip to content

Installation

You can install marimo alongside your notebook's packages using any major Python package manager. With pip or Conda, you'll first need to create and activate a virtual environment or Conda environment. Project managers such as uv and Pixi handle this setup automatically when you launch marimo from your project with uv run or pixi run.

Try a standalone notebook

uv and Pixi can manage Python and install marimo for you without setting up a project. To try a notebook with its own dependencies:

uvx marimo edit --sandbox notebook.py

pixi exec marimo edit --sandbox=pixi notebook.py

To add marimo to an existing codebase, see working in projects. See package management to compare projects and notebook sandboxes.

Use our editor extensions

Try our VS Code extension, which works in VS Code, Cursor, and other VS Code forks, or our PyCharm plugin.

Install with minimal dependencies

To install marimo, run the following in a terminal:

pip install marimo

To check if the install worked, run

marimo tutorial intro

From your project directory (run uv init first for a new project):

uv add marimo

To check if the install worked, run

uv run marimo tutorial intro

From your project directory (run pixi init --format pyproject first for a new project):

pixi add --pypi marimo

To check if the install worked, run

pixi run marimo tutorial intro

conda install -c conda-forge marimo

To check if the install worked, run

marimo tutorial intro

A tutorial notebook should open in your browser.

Installation issues?

Having installation issues? Reach out to us at GitHub or on Discord.

marimo is lightweight, with few dependencies, to maximize compatibility with your own environments.

To unlock additional features in the marimo editor, including SQL cells, AI completion, server-side plotting of dataframe columns, and more, we suggest installing marimo[recommended]:

pip install "marimo[recommended]"

uv add "marimo[recommended]"

conda install -c conda-forge marimo "duckdb>=1.0.0" "altair>=5.4.0" pyarrow "polars>=1.9.0" "sqlglot[c]>=23.4" "openai>=1.55.3" "ruff" "nbformat>=5.7.0" "vegafusion>=2.0.0" "vl-convert-python>=1.0.0"

Installing marimo in this way installs the following additional dependencies and unlocks the following features:

Dependency Feature
duckdb>=1.0.0 SQL cells
altair>=5.4.0 Plotting in datasource viewer
polars[pyarrow]>=1.9.0 SQL output back in Python
sqlglot[c]>=23.4 SQL cells parsing
openai>=1.55.3 AI features
ruff Formatting
nbformat>=5.7.0 Export as IPYNB
vegafusion>=2.0.0 Performant charting
vl-convert-python>=1.0.0 Required by vegafusion