From 3e2798f835e4003c9c8a337b08cd8e31cc4bb80f Mon Sep 17 00:00:00 2001
From: Adam <62897873+YeIIcw@users.noreply.github.com>
Date: Mon, 1 Dec 2025 13:00:40 -0500
Subject: [PATCH] Python Compatibility (3.14) Note

---
 README.md                                    | 4 ++++
 docs/content/docs/get-started/quickstart.mdx | 4 ++++
 libs/python/agent/pyproject.toml             | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 libs/python/computer/pyproject.toml          | 2 +-
 libs/python/core/pyproject.toml              | 2 +-
 libs/python/mcp-server/pyproject.toml        | 2 +-
 libs/python/som/pyproject.toml               | 2 +-
 8 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 395519f1..b0769460 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,10 @@ Core utilities for Cua
 - [Get started with the Cua SDKs](https://cua.ai/docs/quickstart-devs)
 - [Get started with the Cua CLI](https://cua.ai/docs/quickstart-cli)
 
+## Python Version Compatibility
+
+Cua packages require **Python 3.12 or 3.13**. Python 3.14 is not currently supported due to dependency compatibility issues (pydantic-core/PyO3 compatibility). If you encounter build errors on Python 3.14, please use Python 3.13 or earlier.
+
 # Agent SDK
 
 Install the agent SDK:
diff --git a/docs/content/docs/get-started/quickstart.mdx b/docs/content/docs/get-started/quickstart.mdx
index f342b4ce..6f3deea8 100644
--- a/docs/content/docs/get-started/quickstart.mdx
+++ b/docs/content/docs/get-started/quickstart.mdx
@@ -122,6 +122,10 @@ You can run your Cua computer in the cloud (recommended for easiest setup), loca
 
 ## Developer Quickstart
 
+<Callout type="warn" title="Python Version Compatibility">
+  Cua packages require **Python 3.12 or 3.13**. Python 3.14 is not currently supported due to dependency compatibility issues (pydantic-core/PyO3 compatibility). If you encounter build errors on Python 3.14, please use Python 3.13 or earlier.
+</Callout>
+
 <Steps>
 
 <Step>
diff --git a/libs/python/agent/pyproject.toml b/libs/python/agent/pyproject.toml
index 8e187716..2e60f648 100644
--- a/libs/python/agent/pyproject.toml
+++ b/libs/python/agent/pyproject.toml
@@ -24,7 +24,7 @@ dependencies = [
     "certifi>=2024.2.2",
     "litellm>=1.74.12"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 
 [project.optional-dependencies]
 openai = []
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index 7bae1e06..07dc51df 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -12,7 +12,7 @@ authors = [
 ]
 readme = "README.md"
 license = { text = "MIT" }
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 dependencies = [
     "fastapi>=0.111.0",
     "uvicorn[standard]>=0.27.0",
diff --git a/libs/python/computer/pyproject.toml b/libs/python/computer/pyproject.toml
index b3aca539..3d811b56 100644
--- a/libs/python/computer/pyproject.toml
+++ b/libs/python/computer/pyproject.toml
@@ -19,7 +19,7 @@ dependencies = [
     "pydantic>=2.11.1",
     "mslex>=1.3.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 
 [project.optional-dependencies]
 lume = [
diff --git a/libs/python/core/pyproject.toml b/libs/python/core/pyproject.toml
index cf1ff6c7..5e2dac24 100644
--- a/libs/python/core/pyproject.toml
+++ b/libs/python/core/pyproject.toml
@@ -15,7 +15,7 @@ dependencies = [
     "httpx>=0.24.0",
     "posthog>=3.20.0"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 
 [tool.pdm]
 distribution = true
diff --git a/libs/python/mcp-server/pyproject.toml b/libs/python/mcp-server/pyproject.toml
index 088ae9ec..efcea42c 100644
--- a/libs/python/mcp-server/pyproject.toml
+++ b/libs/python/mcp-server/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 name = "cua-mcp-server"
 description = "MCP Server for Computer-Use Agent (CUA)"
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 version = "0.1.15"
 authors = [
     {name = "TryCua", email = "gh@trycua.com"}
diff --git a/libs/python/som/pyproject.toml b/libs/python/som/pyproject.toml
index d5fac5c9..bfaf4481 100644
--- a/libs/python/som/pyproject.toml
+++ b/libs/python/som/pyproject.toml
@@ -24,7 +24,7 @@ dependencies = [
     "typing-extensions>=4.9.0",
     "pydantic>=2.6.3"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 readme = "README.md"
 license = {text = "AGPL-3.0-or-later"}
 keywords = ["computer-vision", "ocr", "ui-analysis", "icon-detection"]