Getting Marimo Up and Running on Windows with uv

1. Install uv

First, you need to ensure uv is installed on your system and accessible from your command line (PowerShell or Command Prompt).

Open a PowerShell window and run the following command:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

This command downloads the installer script and executes it, which should install uv and add it to your system’s PATH.

• Verification: After installation, close and reopen your PowerShell window, and then run:

uv --version

If it shows the version number, you’re all set!

2. Install Marimo

It’s best practice to use a virtual environment. You can use uv to create a virtual environment, install Marimo, and run commands within it.

• 1. Create a New Directory for your project and navigate into it:

mkdir MarimoProject
cd MarimoProject

• 2. Initialize a uv project (this creates a virtual environment and a pyproject.toml file for dependency tracking):

uv init

• 3. Install Marimo into your new project environment:

uv add marimo

To unlock extra features like SQL cells and AI integration, you can use:

uv add "marimo[recommended]"

3. Start a Marimo Notebook

Now you can use uv run to execute the marimo command installed in your virtual environment.

• 1. Start a new Marimo notebook (it will create a new file named my_notebook.py if it doesn’t exist)

uv run marimo edit my_notebook.py

• 2. This command will launch the Marimo server and automatically open the notebook editor in your default web browser!