Support Python 3.11 for AgentIQ (#148)

- Downgrades Python requirement from `3.12` to `3.11` across all packages
- Adds compatibility layer for `typing.override` decorator `type_utils.py`
- Replaces all `@typing.override` instances with the compatible version

## By Submitting this PR I confirm:
- I am familiar with the [Contributing Guidelines](https://github.com/NVIDIA/AgentIQ/blob/develop/docs/source/advanced/contributing.md).
- We require that all contributors "sign-off" on their commits. This certifies that the contribution is your original work, or you have rights to submit it under the same license, or a compatible license.
  - Any contribution which contains commits that are not Signed-Off will not be accepted.
- When the PR is ready for review, new or existing tests cover these changes.
- When the PR is ready for review, the documentation is up to date with these changes.

Authors:
  - Yuchen Zhang (https://github.com/yczhang-nv)

Approvers:
  - Michael Demoret (https://github.com/mdemoret-nv)

URL: #148

Author: yczhang-nv

README.md

@@ -60,6 +60,7 @@ Before you begin using AgentIQ, ensure that you meet the following software prer
 - Install [Git](https://git-scm.com/)
 - Install [Git Large File Storage](https://git-lfs.github.com/) (LFS)
 - Install [uv](https://docs.astral.sh/uv/getting-started/installation/)
+- Install [Python (3.11 or above)](https://www.python.org/downloads/)
 
 ### Install From Source
 
@@ -86,6 +87,12 @@ Before you begin using AgentIQ, ensure that you meet the following software prer
     uv venv --seed .venv
     source .venv/bin/activate
     ```
+    Make sure the environment is built with Python version `3.11` or above. If you have multiple Python versions installed,
+    you can specify the desired version using the `--python` flag. For example, to use Python 3.11:
+    ```bash
+    uv venv --seed .venv --python 3.11
+    ```
+    You can replace `--python 3.11` with any other Python version (3.11 or above) that you have installed.
 
 5. Install the AgentIQ library.
     To install the AgentIQ library along with all of the optional dependencies. Including developer tools (`--all-groups`) and all of the dependencies needed for profiling and plugins (`--all-extras`) in the source repository, run the following:

examples/agno_personal_finance/pyproject.toml

@@ -13,7 +13,7 @@ dependencies = [
   "openai~=1.66",
   "litellm~=1.63.14"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Custom AgentIQ Workflow using Agno for personal finance"
 classifiers = ["Programming Language :: Python"]
 

examples/automated_description_generation/pyproject.toml

@@ -11,7 +11,7 @@ dynamic = ["version"]
 dependencies = [
   "aiqtoolkit[langchain]"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Automated Generation Description AI-Q example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/documentation_guides/workflows/text_file_ingest/pyproject.toml

@@ -10,7 +10,7 @@ dependencies = [
   "bs4==0.0.2",
   "faiss-cpu==1.9.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Ingest data from text files"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/email_phishing_analyzer/pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
   "networkx~=3.4",
   "openinference-instrumentation-langchain==0.1.29",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Simple Phishing Email Analyzer AgentIQ example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/multi_frameworks/pyproject.toml

@@ -14,7 +14,7 @@ dependencies = [
   "markdown-it-py~=3.0",
   "nvidia-haystack==0.1.2",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Custom AgentIQ Workflow"
 classifiers = ["Programming Language :: Python"]
 

examples/plot_charts/pyproject.toml

@@ -13,7 +13,7 @@ dependencies = [
   "matplotlib==3.9.*",
   "seaborn==0.13.*",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Simple AgentIQ example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/semantic_kernel_demo/pyproject.toml

@@ -12,7 +12,7 @@ dependencies = [
   "aiqtoolkit[langchain,semantic-kernel]",
   "faiss-cpu==1.9.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Simple AgentIQ example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/simple/pyproject.toml

@@ -12,7 +12,7 @@ dependencies = [
   "aiqtoolkit[langchain]",
   "faiss-cpu==1.9.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Simple AgentIQ example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/simple_calculator/pyproject.toml

@@ -11,7 +11,7 @@ dynamic = ["version"]
 dependencies = [
   "aiqtoolkit[langchain]",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Simple Calculator AgentIQ example"
 keywords = ["ai", "rag", "agents"]
 classifiers = ["Programming Language :: Python"]

examples/swe_bench/pyproject.toml

@@ -12,7 +12,7 @@ dependencies = [
   "aiqtoolkit[langchain]",
   "swebench==3.0.3"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Example for solving SWE bench problems"
 classifiers = ["Programming Language :: Python"]
 

packages/aiqtoolkit_agno/pyproject.toml

@@ -24,7 +24,7 @@ dependencies = [
   "openai~=1.66",
   "google-search-results~=2.4.2",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 readme = "src/aiq/meta/pypi.md"
 description = "Subpackage for Agno integration in AIQToolkit"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_crewai/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
   "aiqtoolkit",
   "crewai~=0.95.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 readme = "src/aiq/meta/pypi.md"
 description = "Subpackage for CrewAI integration in AIQToolkit"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_langchain/pyproject.toml

@@ -27,7 +27,7 @@ dependencies = [
   "langgraph~=0.2.50",
   "langchain-milvus~=0.1.8"
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Subpackage for Langchain/Langgraph integration in AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_llama_index/pyproject.toml

@@ -28,7 +28,7 @@ dependencies = [
   "llama-index-readers-file==0.4.4",
   "llama-index==0.12.15",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Subpackage for Llama-Index integration in AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_mem0ai/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
   "aiqtoolkit",
   "mem0ai~=0.1.30",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Subpackage for Mem0 memory integration in AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "agents", "memory"]

packages/aiqtoolkit_semantic_kernel/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
   "aiqtoolkit",
   "semantic-kernel~=1.24.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Subpackage for Semantic-Kernel integration in AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_test/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
   "aiqtoolkit",
   "pytest~=8.3",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Testing utilities for AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "rag", "agents"]

packages/aiqtoolkit_zep_cloud/pyproject.toml

@@ -22,7 +22,7 @@ dependencies = [
   "aiqtoolkit",
   "zep-cloud~=2.2.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 description = "Subpackage for Zep memory integration in AIQToolkit"
 readme = "src/aiq/meta/pypi.md"
 keywords = ["ai", "agents", "memory"]

pyproject.toml

@@ -43,7 +43,7 @@ dependencies = [
   "uvicorn[standard]~=0.32.0",
   "wikipedia~=1.4",
 ]
-requires-python = "==3.12.*"
+requires-python = ">=3.11"
 description = "Agent Intelligence Toolkit (AIQ Toolkit)"
 readme = "src/aiq/meta/pypi.md"
 license = { file = "LICENSE.md" }
@@ -275,7 +275,7 @@ persistent = true
 
 # Minimum Python version to use for version dependent checks. Will default to the
 # version used to run pylint.
-py-version = "3.12"
+py-version = "3.11"
 
 # Discover python modules and packages in the file system subtree.
 # recursive =

src/aiq/builder/eval_builder.py

@@ -15,7 +15,6 @@
 
 import dataclasses
 import logging
-import typing
 from contextlib import asynccontextmanager
 from pathlib import Path
 
@@ -28,6 +27,7 @@
 from aiq.data_models.config import GeneralConfig
 from aiq.data_models.evaluate import EvalGeneralConfig
 from aiq.data_models.evaluator import EvaluatorBaseConfig
+from aiq.utils.type_utils import override
 
 logger = logging.getLogger(__name__)
 
@@ -48,7 +48,7 @@ def __init__(self,
         self.eval_general_config = eval_general_config
         self._evaluators: dict[str, ConfiguredEvaluator] = {}
 
-    @typing.override
+    @override
     async def add_evaluator(self, name: str, config: EvaluatorBaseConfig):
         if name in self._evaluators:
             raise ValueError(f"Evaluator `{name}` already exists in the list of evaluators")
@@ -63,15 +63,15 @@ async def add_evaluator(self, name: str, config: EvaluatorBaseConfig):
             logger.error("Error %s adding evaluator `%s` with config `%s`", e, name, config, exc_info=True)
             raise
 
-    @typing.override
+    @override
     def get_evaluator(self, evaluator_name: str) -> EvaluatorInfo:
 
         if (evaluator_name not in self._evaluators):
             raise ValueError(f"Evaluator `{evaluator_name}` not found")
 
         return self._evaluators[evaluator_name].instance
 
-    @typing.override
+    @override
     def get_evaluator_config(self, evaluator_name: str) -> EvaluatorBaseConfig:
 
         if evaluator_name not in self._evaluators:
@@ -80,15 +80,15 @@ def get_evaluator_config(self, evaluator_name: str) -> EvaluatorBaseConfig:
         # Return the tool configuration object
         return self._evaluators[evaluator_name].config
 
-    @typing.override
+    @override
     def get_max_concurrency(self) -> int:
         return self.eval_general_config.max_concurrency
 
-    @typing.override
+    @override
     def get_output_dir(self) -> Path:
         return self.eval_general_config.output_dir
 
-    @typing.override
+    @override
     def get_all_tools(self, wrapper_type: LLMFrameworkEnum | str):
         tools = []
         tool_wrapper_reg = self._registry.get_tool_wrapper(llm_framework=wrapper_type)