Installation

Before installing marimo, we recommend creating and activating a Python virtual environment.

Setting up a virtual environment

Python uses virtual environments to minimize conflicts among packages. Here’s a quickstart for pip users. If you use conda, please use a conda environment instead.

Run the following in the terminal:

• create an environment with python -m venv marimo-env

• activate the environment:

  • macOS/Unix: source marimo-env/bin/activate

  • Windows: marimo-env\Scripts\activate

Make sure the environment is activated before installing marimo and when using marimo. Install other packages you may need, such as numpy, pandas, matplotlib, and altair, in this environment. When you’re done, deactivate the environment with deactivate in the terimnal.

Learn more from the official Python tutorial.

Using uv?

uv is a next-generation Python package installer and manager that is 10-100x faster than pip, and also makes it easy to install Python and manage projects. With uv, creating a virtual environment is as easy as uv venv.

To install marimo, run the following in a terminal:

install with pip

pip install marimo

install with uv

uv pip install marimo

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.

Installation issues?

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