build(deps): drop unused runtime deps; support Python 3.10 and declare >=3.10

Makefile

@@ -28,7 +28,7 @@ PROTOC_DIR := protoc_gen_openapiv2
 setup: create-venv
 	@echo "Installing SDK dependencies in $(VENV_DIR)..."
 	$(VENV_PIP) install --upgrade pip
-	$(VENV_PIP) install -e ".[flask,fastapi,django]"
+	$(VENV_PIP) install -e ".[flask,fastapi,django,dev]"
 
 create-venv:
 	@if [ ! -d "$(VENV_DIR)" ]; then \

README.md

@@ -80,9 +80,7 @@ To use the Scalekit Python SDK, you must have the following:
 
 | Component | Version |
 | --------- | ------- |
-| Python    | 3.8+    |
-
-> **Tip:** Although Python 3.8 meets the minimum requirement, using a more recent version (such as Python 3.9 or later) is advisable.
+| Python    | 3.10+   |
 
 
 ## Examples - SSO with FastAPI

scalekit/organization.py

@@ -1,3 +1,7 @@
+# Postponed annotations: Optional[TimeUnit] wraps a protobuf enum wrapper
+# object, which typing rejects at import time on Python 3.10.
+from __future__ import annotations
+
 from typing import Optional, List, Dict
 
 from google.protobuf import wrappers_pb2

setup.py

@@ -12,18 +12,15 @@
     install_requires=[
         "grpcio>=1.81.0,<2.0",
         "protobuf>=5.29.5,<8.0.0",
-        "google>=3.0",
         "requests>=2.34.0",
         "PyJWT>=2.13.0",
-        "cffi>=1.15.1",
         "cryptography>=50.0.0",
-        "setuptools>=82.0.1,<83.0",
         "grpcio-status>=1.81.0,<2.0",
         "protoc-gen-openapiv2>=0.0.1",
         "googleapis-common-protos>=1.75.0",
-        "deprecation>=2.1.0",
+        # Not imported by the SDK, but kept: docs and customer code call
+        # load_dotenv() relying on the SDK to install it.
         "python-dotenv>=1.2.2,<2.0",
-        "Faker>=33.0.0,<41.0",
         "pydantic>=2.13.4",
         "mcp>=1.27.2",
     ],
@@ -34,6 +31,9 @@
         "flask": ["flask>=2.0"],
         "fastapi": ["fastapi>=0.100"],
         "django": ["django>=4.2"],
+        # Test-only dependencies (several tests generate fixtures with Faker).
+        # Installed by `make setup`.
+        "dev": ["Faker>=33.0.0,<41.0"],
     },
     url="https://github.com/scalekit-inc/scalekit-sdk-python",
     license="MIT",
@@ -42,8 +42,16 @@
     description="Scalekit official Python SDK",
     long_description=open("README.md").read(),
     long_description_content_type="text/markdown",
+    # grpcio, protobuf and mcp all require Python 3.10+.
+    python_requires=">=3.10",
     classifiers=[
         "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
         "License :: OSI Approved :: MIT License",
         "Operating System :: OS Independent",
     ],

tests/TEST_README.md

@@ -3,7 +3,7 @@
 To run the test cases for this project, follow the steps below:
 
 ### Prerequisites
-1. Ensure you have Python 3.8 or higher installed.
+1. Ensure you have Python 3.10 or higher installed.
 2. Install the required dependencies by running:
    ```sh
    python3 setup.py install