Getting Marimo Up and Running on Windows with uv
Nazanin Ashrafi

Nazanin Ashrafi @nazanin_ashrafi

About: | Sharing my Python journey 🐍 | | Building silly things | | Writing articles, sometimes |

Joined:
Aug 12, 2020

Getting Marimo Up and Running on Windows with uv

Publish Date: Nov 14
18 2

Getting Started with Marimo on Windows (using uv)

Let's install the Marimo Python notebook on Windows with uv.


1. Get the uv Installer

First, we need to install uv.

  • Open PowerShell:
  • Run this command:
powershell -c "irm [https://astral.sh/uv/install.ps1](https://astral.sh/uv/install.ps1) | iex"
Enter fullscreen mode Exit fullscreen mode
  • Check if it worked!

To make sure the install was successful, close and reopen your PowerShell window, then type:

uv --version
Enter fullscreen mode Exit fullscreen mode

If you see a version number, you're good to go!


2. Set Up Your Marimo Project

  • 1. Create a Project Folder: Let's make a new folder and move into it:
mkdir MarimoProject
cd MarimoProject
Enter fullscreen mode Exit fullscreen mode
  • 2.Initialize the Project: This command tells uv to create a virtual environment inside this folder:
uv init
Enter fullscreen mode Exit fullscreen mode
  • 3. Install Marimo Now, let's add the Marimo package to your new environment:
uv add marimo
Enter fullscreen mode Exit fullscreen mode

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

uv add "marimo[recommended]"
Enter fullscreen mode Exit fullscreen mode

3. Launch Your Marimo Notebook!

Everything is installed! Now we use uv to run the Marimo tool we just installed.

  • 1. Start the Editor: (it will create a new file named my_notebook.py if it doesn't exist)
uv run marimo edit my_notebook.py
Enter fullscreen mode Exit fullscreen mode
  • 2. Go to Your Browser: This command will automatically open the interactive Marimo notebook editor in your default web browser. You can now start writing your Python code!

Comments 2 total

  • Shahrouz Nikseresht
    Shahrouz NiksereshtNov 14, 2025

    Awesome guide! Super clear on getting Marimo running on Windows with uv. Loved how you laid out the commands so simply 😍🙌🏽

  • Briana Bradshaw
    Briana BradshawNov 14, 2025

    Love this!! Thanks for sharing with us

Add comment