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