From cb70d3d437cdfdd6c3ba004faed6d6bdec0f74f7 Mon Sep 17 00:00:00 2001 From: Hongming Wang Date: Tue, 5 May 2026 13:44:25 -0700 Subject: [PATCH] docs: callout Python>=3.11 requirement on Universal MCP install snippet MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit User-reported friction: pip install molecule-ai-workspace-runtime on a 3.10 interpreter fails with "Could not find a version that satisfies the requirement (from versions: none)" — pip's requires_python filter silently drops the only available artifact before attempting install, so the error doesn't mention Python at all. Operators see "package missing", file a bug, and chase a phantom CDN/visibility issue. Two changes mirror the requirement at the two operator-touch surfaces: 1. workspace-server/internal/handlers/external_connection.go: the externalUniversalMcpTemplate snippet (rendered into the canvas Connect-External-Agent modal) now leads with a brief "Requires Python >= 3.11" block + diagnostic + upgrade paths. 2. docs/workspace-runtime-package.md: same callout at the top of the doc, before the Overview, so anyone landing here from search gets the answer immediately. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/workspace-runtime-package.md | 9 +++++++++ .../internal/handlers/external_connection.go | 7 +++++++ 2 files changed, 16 insertions(+) diff --git a/docs/workspace-runtime-package.md b/docs/workspace-runtime-package.md index 1b2927e2..aec351bc 100644 --- a/docs/workspace-runtime-package.md +++ b/docs/workspace-runtime-package.md @@ -1,5 +1,14 @@ # Workspace Runtime PyPI Package +## Requires Python >= 3.11 + +The wheel pins `requires_python>=3.11`. On Python 3.10 or older, `pip install +molecule-ai-workspace-runtime` fails with `Could not find a version that +satisfies the requirement (from versions: none)` — the pin filters the only +available artifact before pip even attempts install. Upgrade the interpreter +(`brew install python@3.12` / `apt install python3.12` / etc.) or use a +3.11+ venv. + ## Overview The shared workspace runtime infrastructure has **one editable source** and diff --git a/workspace-server/internal/handlers/external_connection.go b/workspace-server/internal/handlers/external_connection.go index b12d08fa..c10bf059 100644 --- a/workspace-server/internal/handlers/external_connection.go +++ b/workspace-server/internal/handlers/external_connection.go @@ -198,6 +198,13 @@ const externalUniversalMcpTemplate = `# Universal MCP — standalone register + # Pair with the Claude Code or Python SDK tab if your runtime needs # inbound A2A delivery (canvas messages → agent conversation turns). +# Requires Python >= 3.11. On 3.10 or older pip says +# "Could not find a version that satisfies the requirement +# (from versions: none)" — the wheel's requires_python pin filters +# the only available artifact before pip even attempts install. +# Upgrade the interpreter (brew install python@3.12 / apt install +# python3.12 / etc.) or use a 3.11+ venv. + # 1. Install the workspace runtime wheel: pip install molecule-ai-workspace-runtime