fix: Use typing_extensions for Self in Python < 3.11

Adds typing_extensions as a dependency and uses a conditional
import for the Self type in src/crewai/memory/memory.py to
ensure compatibility with Python 3.10, resolving the
ImportError seen in CI.

Refs #2575

Co-Authored-By: Joe Moura <joao@crewai.com>

.github/workflows/tests.yml

@@ -11,6 +11,10 @@ env:
 jobs:
   tests:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+      fail-fast: false # Allow all matrix jobs to finish even if one fails
     timeout-minutes: 15
     steps:
       - name: Checkout code
@@ -22,8 +26,8 @@ jobs:
           enable-cache: true
 
 
-      - name: Set up Python
-        run: uv python install 3.12.8
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
 
       - name: Install the project
         run: uv sync --dev --all-extras

pyproject.toml

@@ -38,6 +38,7 @@ dependencies = [
     "blinker>=1.9.0",
     "json5>=0.10.0",
 ]
+    "typing-extensions>=4.7.0", # For Self type backport
 
 [project.urls]
 Homepage = "https://crewai.com"

src/crewai/memory/memory.py

@@ -1,4 +1,10 @@
-from typing import Any, Dict, List, Optional, Self
+import sys
+from typing import Any, Dict, List, Optional
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from typing_extensions import Self
 
 from pydantic import BaseModel
 

tests/test_compatibility.py

@@ -0,0 +1,15 @@
+import pytest
+
+
+def test_basic_import():
+    """
+    Tests that the crewai package can be imported without raising exceptions.
+    This helps catch basic installation and dependency issues, including import
+    errors related to Python version compatibility.
+    """
+    try:
+        import crewai
+    except ImportError as e:
+        pytest.fail(f"Failed to import crewai package: {e}")
+    except Exception as e:
+        pytest.fail(f"An unexpected error occurred during crewai import: {e}")