python-compat

python-compat

Check Python version compatibility with installed AI libraries and detect dependency cascades.

Usage

env-doctor python-compat [--json]

Description

The python-compat command checks if your current Python version is compatible with installed AI libraries like PyTorch, TensorFlow, JAX, NumPy, SciPy, and others. It identifies:

• Version conflicts: When your Python version is outside a library's supported range
• Dependency cascades: When one library's constraint forces version limits on downstream packages

Options

Option	Description
--json	Output results in JSON format for programmatic consumption

Output

Human-readable format (default)

🐍  PYTHON VERSION COMPATIBILITY CHECK
============================================================
Python Version: 3.13 (3.13.0)
Libraries Checked: 2

❌  2 compatibility issue(s) found:

    tensorflow:
      tensorflow supports Python <=3.12, but you have Python 3.13
      Note: TensorFlow 2.15+ requires Python 3.9-3.12. Python 3.13 not yet supported.

    torch:
      torch supports Python <=3.12, but you have Python 3.13
      Note: PyTorch 2.x supports Python 3.9-3.12. Python 3.13 support experimental.

⚠️   Dependency Cascades:
    tensorflow [high]: TensorFlow's Python ceiling propagates to keras and tensorboard
      Affected: keras, tensorboard, tensorflow-estimator
    torch [high]: PyTorch's Python version constraint affects all torch ecosystem packages
      Affected: torchvision, torchaudio, triton

💡  Consider using Python 3.12 or lower for full compatibility

💡  Cascade: tensorflow constraint also affects: keras, tensorboard, tensorflow-estimator

💡  Cascade: torch constraint also affects: torchvision, torchaudio, triton

============================================================

JSON format (--json)

{
  "component": "python_compat",
  "status": "error",
  "detected": false,
  "version": "3.13",
  "path": null,
  "metadata": {
    "python_full_version": "3.13.0",
    "conflicts": [
      {
        "library": "tensorflow",
        "min_version": "3.9",
        "max_version": "3.12",
        "notes": "TensorFlow 2.15+ requires Python 3.9-3.12. Python 3.13 not yet supported.",
        "type": "above_maximum",
        "message": "tensorflow supports Python <=3.12, but you have Python 3.13"
      },
      {
        "library": "torch",
        "min_version": "3.9",
        "max_version": "3.12",
        "notes": "PyTorch 2.x supports Python 3.9-3.12. Python 3.13 support experimental.",
        "type": "above_maximum",
        "message": "torch supports Python <=3.12, but you have Python 3.13"
      }
    ],
    "cascades": [
      {
        "root_library": "tensorflow",
        "affected_dependencies": ["keras", "tensorboard", "tensorflow-estimator"],
        "severity": "high",
        "description": "TensorFlow's Python ceiling propagates to keras and tensorboard"
      },
      {
        "root_library": "torch",
        "affected_dependencies": ["torchvision", "torchaudio", "triton"],
        "severity": "high",
        "description": "PyTorch's Python version constraint affects all torch ecosystem packages"
      }
    ],
    "constraints_checked": 2
  },
  "issues": [
    "tensorflow supports Python <=3.12, but you have Python 3.13",
    "torch supports Python <=3.12, but you have Python 3.13"
  ],
  "recommendations": [
    "Consider using Python 3.12 or lower for full compatibility",
    "Cascade: tensorflow constraint also affects: keras, tensorboard, tensorflow-estimator",
    "Cascade: torch constraint also affects: torchvision, torchaudio, triton"
  ]
}