DEV Community

Cover image for Getting Marimo Up and Running on Windows with uv
Nazanin Ashrafi
Nazanin Ashrafi

Posted on

Getting Marimo Up and Running on Windows with uv

#python #uv #notebook

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!

Top comments (1)

Collapse
 
shahrouzlogs profile image
Shahrouz Nikseresht •

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