Skip to content

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.

docs: clarify pixi vs hatch setup guidance in CONTRIBUTING (#8291)

axssel55b115269bb6
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a481f41c47..df3ed83c32 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -29,6 +29,11 @@ Install [pixi](https://github.com/prefix-dev/pixi) to manage your development en
> As an alternative to installing `pixi`, you can try developing in [Gitpod](https://gitpod.io/#https://github.com/marimo-team/marimo).
> Note that developing in Gitpod is not officially supported by the marimo team.
+> [!TIP]
+> New to both `pixi` and `hatch`? Pick `pixi`. It installs and manages both the Python and Node toolchains, then drops you into a ready shell with one command. Choose `hatch` only if you already maintain Node 20+/pnpm 9+ yourself and just want a Python environment manager. Typical flows:
+> - `pixi shell` → `make fe && make py` → `make dev`
+> - `hatch shell` → `make fe && make py` → `make dev`
+
```bash
pixi shell
```