Python Compatibility (3.14) Note

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:

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>

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 = []

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",

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 = [

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

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"}

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"]