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.

Keep sandbox package managers fixed in install alerts (#10983)

Trevor Manz834399162105
diff --git a/frontend/src/components/editor/__tests__/package-alert.test.tsx b/frontend/src/components/editor/__tests__/package-alert.test.tsx
new file mode 100644
index 0000000000..72f03903b0
--- /dev/null
+++ b/frontend/src/components/editor/__tests__/package-alert.test.tsx
@@ -0,0 +1,140 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { fireEvent, render, screen } from "@testing-library/react";
+import { createStore, Provider } from "jotai";
+import { expect, it, vi } from "vitest";
+import { MockRequestClient } from "@/__mocks__/requests";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { alertAtom } from "@/core/alerts/state";
+import {
+ defaultUserConfig,
+ type PackageManagerName,
+} from "@/core/config/config-schema";
+import { userConfigAtom } from "@/core/config/config";
+import { requestClientAtom } from "@/core/network/requests";
+import { sandboxAtom } from "@/core/packages/sandbox-state";
+import { PackageAlert } from "../package-alert";
+
+vi.mock("@/hooks/usePackageMetadata", () => ({
+ usePackageMetadata: () => ({
+ data: { versions: ["1.2.3"], extras: [] },
+ error: null,
+ isPending: false,
+ }),
+}));
+
+function mountPackageAlert({
+ configuredManager,
+ sandboxBackend,
+ source = "kernel",
+}: {
+ configuredManager: PackageManagerName;
+ sandboxBackend: "uv" | "pixi" | null;
+ source?: "kernel" | "server";
+}) {
+ const store = createStore();
+ const client = MockRequestClient.create();
+ const config = defaultUserConfig();
+ store.set(userConfigAtom, {
+ ...config,
+ package_management: { manager: configuredManager },
+ });
+ store.set(requestClientAtom, client);
+ store.set(
+ sandboxAtom,
+ sandboxBackend
+ ? {
+ backend: sandboxBackend,
+ manifest: "",
+ filename: "notebook.py",
+ }
+ : null,
+ );
+ store.set(alertAtom, {
+ ...store.get(alertAtom),
+ packageAlert: {
+ id: "missing-package",
+ kind: "missing",
+ packages: ["polars"],
+ isolated: true,
+ source,
+ },
+ });
+ render(
+ <Provider store={store}>
+ <TooltipProvider>
+ <PackageAlert />
+ </TooltipProvider>
+ </Provider>,
+ );
+ return client;
+}
+
+it.each(["uv", "pixi"] as const)(
+ "shows the fixed %s manager for a sandbox",
+ (sandboxBackend) => {
+ const client = mountPackageAlert({
+ configuredManager: sandboxBackend === "uv" ? "pixi" : "uv",
+ sandboxBackend,
+ });
+
+ const managerSelect = screen.getByTestId("install-package-manager-select");
+ expect(managerSelect).toHaveValue(sandboxBackend);
+ expect(managerSelect).toBeDisabled();
+
+ fireEvent.click(screen.getByTestId("install-packages-button"));
+ expect(client.sendInstallMissingPackages).toHaveBeenCalledWith(
+ expect.objectContaining({ manager: sandboxBackend }),
+ );
+ },
+);
+
+it("keeps the configured package manager selectable outside a sandbox", () => {
+ mountPackageAlert({ configuredManager: "uv", sandboxBackend: null });
+
+ const managerSelect = screen.getByTestId("install-package-manager-select");
+ expect(managerSelect).toHaveValue("uv");
+ expect(managerSelect).not.toBeDisabled();
+});
+
+it("installs a selected version in a Pixi sandbox", () => {
+ const client = mountPackageAlert({
+ configuredManager: "uv",
+ sandboxBackend: "pixi",
+ });
+
+ fireEvent.change(screen.getByDisplayValue("latest"), {
+ target: { value: "1.2.3" },
+ });
+ fireEvent.click(screen.getByTestId("install-packages-button"));
+ expect(client.sendInstallMissingPackages).toHaveBeenCalledExactlyOnceWith({
+ manager: "pixi",
+ versions: { polars: "1.2.3" },
+ source: "kernel",
+ });
+});
+
+it("does not offer version selection for Pixi outside a sandbox", () => {
+ mountPackageAlert({ configuredManager: "pixi", sandboxBackend: null });
+
+ expect(screen.queryByDisplayValue("latest")).not.toBeInTheDocument();
+});
+
+it("uses the configured package manager for a server installation", () => {
+ const client = mountPackageAlert({
+ configuredManager: "uv",
+ sandboxBackend: "pixi",
+ source: "server",
+ });
+
+ expect(
+ screen.queryByTestId("install-package-manager-select"),
+ ).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByTestId("install-packages-button"));
+ expect(client.sendInstallMissingPackages).toHaveBeenCalledExactlyOnceWith({
+ manager: "uv",
+ versions: { polars: "" },
+ source: "server",
+ });
+});
diff --git a/frontend/src/components/editor/package-alert.tsx b/frontend/src/components/editor/package-alert.tsx
index ed34c531fa..f2b9f8983c 100644
--- a/frontend/src/components/editor/package-alert.tsx
+++ b/frontend/src/components/editor/package-alert.tsx
@@ -1,6 +1,7 @@
/* Copyright 2026 Marimo. All rights reserved. */
import { zodResolver } from "@hookform/resolvers/zod";
+import { useAtomValue } from "jotai";
import {
BoxIcon,
CheckIcon,
@@ -34,6 +35,7 @@ import {
import { useResolvedMarimoConfig } from "@/core/config/config";
import type { PackageOperationStatus } from "@/core/kernel/messages";
import { useRequestClient } from "@/core/network/requests";
+import { sandboxAtom } from "@/core/packages/sandbox-state";
import { RESTART_REQUIRED_DESCRIPTION } from "@/core/packages/toast-components";
import { isWasm } from "@/core/wasm/utils";
import { usePackageMetadata } from "@/hooks/usePackageMetadata";
@@ -104,6 +106,7 @@ export const PackageAlert: React.FC = () => {
const { packageAlert } = useAlerts();
const { clearPackageAlert } = useAlertActions();
const [userConfig] = useResolvedMarimoConfig();
+ const sandbox = useAtomValue(sandboxAtom);
const [desiredPackageVersions, setDesiredPackageVersions] = useState<
Record<string, string>
>({});
@@ -132,8 +135,14 @@ export const PackageAlert: React.FC = () => {
return null;
}
+ const sandboxPackageManager =
+ packageAlert.source === "server" ? null : sandbox?.backend;
+ const packageManager =
+ sandboxPackageManager ?? userConfig.package_management.manager;
const doesSupportVersioning =
- userConfig.package_management.manager !== "pixi";
+ packageAlert.source === "server" ||
+ sandbox !== null ||
+ packageManager !== "pixi";
if (isMissingPackageAlert(packageAlert)) {
return (
@@ -207,7 +216,7 @@ export const PackageAlert: React.FC = () => {
{packageAlert.isolated ? (
<>
<InstallPackagesButton
- manager={userConfig.package_management.manager}
+ manager={packageManager}
packages={packageAlert.packages.map((pkg) => {
const parsed = parsePackageSpecifier(pkg);
const currentExtras =
@@ -219,10 +228,12 @@ export const PackageAlert: React.FC = () => {
source={packageAlert.source}
/>
- {!isWasm() && (
+ {!isWasm() && packageAlert.source !== "server" && (
<>
<span className="px-2 text-sm">with</span>{" "}
- <PackageManagerForm />
+ <PackageManagerForm
+ fixedManager={sandboxPackageManager ?? undefined}
+ />
</>
)}
</>
@@ -449,7 +460,9 @@ const InstallPackagesButton = ({
);
};
-const PackageManagerForm: React.FC = () => {
+const PackageManagerForm: React.FC<{
+ fixedManager?: PackageManagerName;
+}> = ({ fixedManager }) => {
const [config, setConfig] = useResolvedMarimoConfig();
const { saveUserConfig } = useRequestClient();
@@ -490,8 +503,8 @@ const PackageManagerForm: React.FC = () => {
<NativeSelect
data-testid="install-package-manager-select"
onChange={(e) => field.onChange(e.target.value)}
- value={field.value}
- disabled={field.disabled}
+ value={fixedManager ?? field.value}
+ disabled={fixedManager !== undefined || field.disabled}
className="inline-flex mr-2"
>
{PackageManagerNames.map((option) => (
diff --git a/marimo/_server/start.py b/marimo/_server/start.py
index 4e49ad0270..aac6560d4f 100644
--- a/marimo/_server/start.py
+++ b/marimo/_server/start.py
@@ -292,13 +292,12 @@ def start(
GLOBAL_SETTINGS.SANDBOX_MODE = "multi"
if GLOBAL_SETTINGS.MANAGE_SCRIPT_METADATA:
+ backend = sandbox or GLOBAL_SETTINGS.SANDBOX_BACKEND
+ package_manager: Backend = "pixi" if backend == "pixi" else "uv"
config_reader = config_reader.with_overrides(
{
- # Currently, only uv is supported for managing script metadata
- # If this changes, instead we should only update the config
- # if the user's package manager does not support sandboxes.
"package_management": {
- "manager": "uv",
+ "manager": package_manager,
}
}
)
diff --git a/tests/_server/test_start.py b/tests/_server/test_start.py
new file mode 100644
index 0000000000..0354c7cc1f
--- /dev/null
+++ b/tests/_server/test_start.py
@@ -0,0 +1,80 @@
+# Copyright 2026 Marimo. All rights reserved.
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+from unittest.mock import patch
+
+import pytest
+
+from marimo._config.settings import GLOBAL_SETTINGS
+from marimo._environments.sandbox import Backend
+from marimo._server.start import start
+from marimo._server.tokens import AuthToken
+from marimo._server.workspace import DirectoryWorkspace
+from marimo._session.model import SessionMode
+
+if TYPE_CHECKING:
+ from pathlib import Path
+
+
+ ("sandbox", "inherited_backend", "expected_manager"),
+ [
+ ("uv", None, "uv"),
+ ("pixi", None, "pixi"),
+ (None, "uv", "uv"),
+ (None, "pixi", "pixi"),
+ (None, None, "pip"),
+ ],
+)
+def test_package_manager_follows_sandbox_backend(
+ tmp_path: Path,
+ monkeypatch: pytest.MonkeyPatch,
+ sandbox: Backend | None,
+ inherited_backend: Backend | None,
+ expected_manager: str,
+) -> None:
+ (tmp_path / "pyproject.toml").write_text(
+ '[tool.marimo.package_management]\nmanager = "pip"\n'
+ )
+ monkeypatch.delenv("MARIMO_ANCESTOR_PID", raising=False)
+ for setting, value in {
+ "SANDBOX_BACKEND": inherited_backend,
+ "SANDBOX_MODE": "single" if inherited_backend else None,
+ "MANAGE_SCRIPT_METADATA": inherited_backend is not None,
+ }.items():
+ monkeypatch.setattr(GLOBAL_SETTINGS, setting, value)
+ monkeypatch.delenv(f"MARIMO_{setting}", raising=False)
+
+ with (
+ patch("marimo._server.start.CompositeLspServer"),
+ patch("marimo._server.start.initialize_fd_limit"),
+ patch("marimo._server.start.initialize_signals"),
+ patch("marimo._server.start.uvicorn.Server", autospec=True) as server,
+ ):
+ start(
+ workspace=DirectoryWorkspace(
+ str(tmp_path), include_markdown=False
+ ),
+ mode=SessionMode.EDIT,
+ development_mode=False,
+ quiet=True,
+ include_code=True,
+ ttl_seconds=None,
+ headless=True,
+ port=2718,
+ host="127.0.0.1",
+ proxy=None,
+ watch=False,
+ cli_args={},
+ argv=[],
+ auth_token=AuthToken(""),
+ redirect_console_to_browser=False,
+ skew_protection=False,
+ sandbox=sandbox,
+ )
+
+ app = server.call_args.args[0].app
+ assert app.state.config_manager.get_config()["package_management"] == {
+ "manager": expected_manager
+ }