Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

4.2 KB
Raw Blame

description: "Install marimo with pip, uv, Pixi, or conda. Use a project manager or set up your own environment to get started."

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.

//// admonition | Try a standalone notebook type: tip

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

/// tab | uv

uvx marimo edit --sandbox notebook.py

///

/// tab | Pixi

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

/// admonition | Use our editor extensions type: tip

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:

/// tab | install with pip

pip install marimo

To check if the install worked, run

marimo tutorial intro

///

/// tab | install with uv

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

///

/// tab | install with Pixi

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

///

/// tab | install with conda

conda install -c conda-forge marimo

To check if the install worked, run

marimo tutorial intro

///

A tutorial notebook should open in your browser.

/// admonition | Installation issues? type: note

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

Install with recommended dependencies

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]:

/// tab | install with pip

pip install "marimo[recommended]"

///

/// tab | install with uv

uv add "marimo[recommended]"

///

/// tab | install with conda

conda install -c conda-forge marimo "duckdb>=1.0.0" "altair>=5.4.0" pyarrow "polars>=1.9.0" "sqlglotc>=30.11.0" "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]>=30.11.0 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