squlearn 0.10.0__tar.gz → 0.11.0__tar.gz

{squlearn-0.10.0 → squlearn-0.11.0}/.github/workflows/elaborate_tests.yaml

@@ -23,14 +23,15 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.9'
+          python-version: '3.10'
       - name: Install dependencies
         run: |
           python -m venv venv_minimal
           source venv_minimal/bin/activate
           python -m pip install --upgrade pip
-          pip install toml autoray==0.7.2 matplotlib-inline==0.1.7
+          pip install toml autoray==0.7.2 matplotlib-inline==0.1.7 "setuptools<81"
           python3 install_lowest_dependencies.py
+          pip install "numpy==1.23.5"
       - name: Test with pytest
         run: |
           source venv_minimal/bin/activate
@@ -40,30 +41,6 @@ jobs:
         run: |
           rm -rf venv_minimal
 
-  pytest_qiskit_0_46:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v5
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.9'
-      - name: Install dependencies
-        run: |
-          python -m venv venv_qiskit_0_46
-          source venv_qiskit_0_46/bin/activate
-          python -m pip install --upgrade pip
-          pip install . qiskit==0.46.3 qiskit-ibm-runtime==0.20.0 autoray==0.7.2
-      - name: Test with pytest
-        run: |
-          source venv_qiskit_0_46/bin/activate
-          pip install pytest
-          pytest tests/
-      - name: clean
-        run: |
-          rm -rf venv_qiskit_0_46
-
   pytest_qiskit_1:
     runs-on: ubuntu-latest
 
@@ -72,13 +49,13 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.9'
+          python-version: '3.13'
       - name: Install dependencies
         run: |
           python -m venv venv_qiskit_1
           source venv_qiskit_1/bin/activate
           python -m pip install --upgrade pip
-          pip install . qiskit==1.1.2 qiskit-algorithms==0.3.0 qiskit-ibm-runtime==0.27.1 autoray==0.7.2
+          pip install . "qiskit<2"
       - name: Test with pytest
         run: |
           source venv_qiskit_1/bin/activate
@@ -94,7 +71,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v5
@@ -111,11 +88,6 @@ jobs:
           source venv_latest/bin/activate
           python -m pip install --upgrade pip
           pip install .[examples]
-      - name: Install old autoray
-        if: matrix.python-version == '3.9'
-        run: |
-          source venv_latest/bin/activate
-          pip install autoray==0.7.2
       - name: Test with pytest
         run: |
           source venv_latest/bin/activate
@@ -136,7 +108,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.9", "3.12"]
+        python-version: ["3.10", "3.13"]
 
     steps:
       - uses: actions/checkout@v5
@@ -152,10 +124,6 @@ jobs:
           python -m venv venv_latest
           .\venv_latest\Scripts\python.exe -m pip install --upgrade pip
           .\venv_latest\Scripts\pip.exe install .
-      - name: Install old autoray
-        if: matrix.python-version == '3.9'
-        run: |
-          .\venv_latest\Scripts\pip.exe install autoray==0.7.2
       - name: Test with pytest
         run: |
           .\venv_latest\Scripts\pip.exe install pytest
@@ -170,7 +138,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.9", "3.12"]
+        python-version: ["3.10", "3.13"]
 
     steps:
       - uses: actions/checkout@v5
@@ -187,11 +155,6 @@ jobs:
           source venv_latest/bin/activate
           python -m pip install --upgrade pip
           pip install .
-      - name: Install old autoray
-        if: matrix.python-version == '3.9'
-        run: |
-          source venv_latest/bin/activate
-          pip install autoray==0.7.2
       - name: Test with pytest
         run: |
           source venv_latest/bin/activate

{squlearn-0.10.0 → squlearn-0.11.0}/.github/workflows/quick_tests.yaml

@@ -18,7 +18,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v5
@@ -35,11 +35,6 @@ jobs:
           source venv_latest/bin/activate
           python -m pip install --upgrade pip
           pip install .
-      - name: Install old autoray
-        if: matrix.python-version == '3.9'
-        run: |
-          source venv_latest/bin/activate
-          pip install autoray==0.7.2
       - name: Test with pytest
         run: |
           source venv_latest/bin/activate

{squlearn-0.10.0 → squlearn-0.11.0}/PKG-INFO

@@ -1,32 +1,37 @@
 Metadata-Version: 2.4
 Name: squlearn
-Version: 0.10.0
+Version: 0.11.0
 Summary: A library for quantum machine learning following the scikit-learn standard.
 Keywords: quantum,machine learning,qml
 Author-email: David Kreplin <david.kreplin@ipa.fraunhofer.de>, Moritz Willmann <moritz.willmann@ipa.fraunhofer.de>, Jan Schnabel <jan.schnabel@ipa.fraunhofer.de>, Frederic Rapp <frederic.rapp@ipa.fraunhofer.de>, Manuel Hagelüken <manuel.hagelueken@ipa.fraunhofer.de>, Marco Roth <marco.roth@ipa.fraunhofer.de>
 Maintainer-email: David Kreplin <david.kreplin@ipa.fraunhofer.de>, Moritz Willmann <moritz.willmann@ipa.fraunhofer.de>
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 License-File: LICENSE.txt
 Requires-Dist: bayesian-optimization>=1.4.3,<2
 Requires-Dist: dill>=0.3.5
-Requires-Dist: mapomatic>=0.10.0
+Requires-Dist: mapomatic>=0.12.0
 Requires-Dist: networkx>=3.0
-Requires-Dist: numpy>=1.20
+Requires-Dist: numpy>=1.22
 Requires-Dist: pennylane>=0.34.0
-Requires-Dist: qiskit>=0.45.0,<2
-Requires-Dist: qiskit-aer>=0.12.0
+Requires-Dist: qiskit>=1.0.0,<3.0.0
+Requires-Dist: qiskit-aer>=0.14.0.1
 Requires-Dist: qiskit-algorithms>=0.3.0
-Requires-Dist: qiskit-ibm-runtime>=0.18.0
+Requires-Dist: qiskit-ibm-runtime>=0.19.0
 Requires-Dist: qiskit-machine-learning>=0.7.0
 Requires-Dist: scipy>=1.8.0
 Requires-Dist: scikit-learn>=1.2.0
+Requires-Dist: sympy>=1.8
 Requires-Dist: tqdm>=4.1.0
 Requires-Dist: qulacs>=0.6.0
-Requires-Dist: black ; extra == "dev"
+Requires-Dist: black[jupyter] ; extra == "dev"
 Requires-Dist: flit ; extra == "dev"
 Requires-Dist: nbmake ; extra == "dev"
 Requires-Dist: pylint ; extra == "dev"
@@ -73,7 +78,7 @@ sQUlearn offers scikit-learn compatible high-level interfaces for various kernel
 
 ## Prerequisites
 
-The package requires **at least Python 3.9**.
+The package requires **at least Python 3.10**.
 ## Install sQUlearn
 
 ### Stable Release
@@ -122,5 +127,18 @@ For general questions regarding sQUlearn, use the [GitHub Discussions](https://g
 
 This project was supported by the German Federal Ministry of Economic Affairs and Climate Action through the projects AutoQML (grant no. 01MQ22002A) and AQUAS (grant no. 01MQ22003D), as well as the German Federal Ministry of Education and Research through the project H2Giga Degrad-EL3 (grant no. 03HY110D).
 
+## Disclaimer
+
+This software is provided strictly for **research and experimental purposes**. It represents early-stage exploratory work and has not been validated, verified, or tested for any operational, commercial, or production use.
+
+**Technology Readiness Level: TRL 1–3** (Basic principles observed through proof-of-concept)
+
+- No claims are made regarding reliability, accuracy, or fitness for any particular purpose
+- The codebase may be incomplete, unstable, or subject to fundamental changes without notice
+- Results produced by this software are not guaranteed to be reproducible or correct
+- This project exists solely for academic inquiry, algorithmic exploration, and open scientific collaboration
+
+This software is not designed, intended, or suitable for deployment in any real-world system or application. Users assume all responsibility for any use beyond basic research experimentation.
+
 ---
 

{squlearn-0.10.0 → squlearn-0.11.0}/README.md

@@ -14,7 +14,7 @@ sQUlearn offers scikit-learn compatible high-level interfaces for various kernel
 
 ## Prerequisites
 
-The package requires **at least Python 3.9**.
+The package requires **at least Python 3.10**.
 ## Install sQUlearn
 
 ### Stable Release
@@ -63,4 +63,17 @@ For general questions regarding sQUlearn, use the [GitHub Discussions](https://g
 
 This project was supported by the German Federal Ministry of Economic Affairs and Climate Action through the projects AutoQML (grant no. 01MQ22002A) and AQUAS (grant no. 01MQ22003D), as well as the German Federal Ministry of Education and Research through the project H2Giga Degrad-EL3 (grant no. 03HY110D).
 
+## Disclaimer
+
+This software is provided strictly for **research and experimental purposes**. It represents early-stage exploratory work and has not been validated, verified, or tested for any operational, commercial, or production use.
+
+**Technology Readiness Level: TRL 1–3** (Basic principles observed through proof-of-concept)
+
+- No claims are made regarding reliability, accuracy, or fitness for any particular purpose
+- The codebase may be incomplete, unstable, or subject to fundamental changes without notice
+- Results produced by this software are not guaranteed to be reproducible or correct
+- This project exists solely for academic inquiry, algorithmic exploration, and open scientific collaboration
+
+This software is not designed, intended, or suitable for deployment in any real-world system or application. Users assume all responsibility for any use beyond basic research experimentation.
+
 ---

{squlearn-0.10.0 → squlearn-0.11.0}/docs/install/install.rst

@@ -6,22 +6,23 @@ Installation
 Prerequisites
 -------------
 
-sQUlearn requires a recent python3 (>=3.9) installation.
+sQUlearn requires a recent python3 (>=3.10) installation.
 Additionally the following python packages are necessary: ::
 
     bayesian-optimization>=1.4.3,<2,
-    dill>=0.3.4,
-    mapomatic>=0.10.0,
+    dill>=0.3.5,
+    mapomatic>=0.12.0,
     networkx>=3.0,
-    numpy>=1.20,
+    numpy>=1.22,
     pennylane>=0.34.0,
-    qiskit>=0.45.0,<2,
-    qiskit-aer>=0.12.0,
+    qiskit>=1.0.0,<3.0.0,
+    qiskit-aer>=0.14.0.1,
     qiskit-algorithms>=0.3.0,
-    qiskit-ibm-runtime>=0.18.0,
+    qiskit-ibm-runtime>=0.19.0,
     qiskit-machine-learning>=0.7.0,
     scipy>=1.8.0,
     scikit-learn>=1.2.0,
+    sympy>=1.8,
     tqdm>=4.1.0,
     qulacs>=0.6.0,
 

{squlearn-0.10.0 → squlearn-0.11.0}/docs/user_guide/encoding_circuits.rst

@@ -83,8 +83,8 @@ It is also possible to utilize the wrapper :class:`QiskitEncodingCircuit` to bui
 .. jupyter-execute::
 
    from squlearn.encoding_circuit import QiskitEncodingCircuit
-   from qiskit.circuit.library import TwoLocal
-   local = TwoLocal(3, 'ry', 'cx', 'linear', reps=2, insert_barriers=True)
+   from qiskit.circuit.library import n_local
+   local = n_local(3, 'ry', 'cx', 'linear', reps=2, insert_barriers=True)
    QiskitEncodingCircuit(local).draw(output="mpl")
 
 

{squlearn-0.10.0 → squlearn-0.11.0}/docs/user_guide/executor.rst

@@ -60,7 +60,9 @@ The :class:`Executor <squlearn.Executor>` class provides the following key comfo
   sub-programs. If the version of the Qiskit installation is larger equal than 1.2, the V2 Primitives are created, otherwise the V1 Primitives are returned.
 - **Qiskit Session handling:** Automatically manages the creation and handling of Qiskit IBM Runtime sessions.
   If Sessions are time out, the :class:`Executor <squlearn.Executor>` automatically creates a new session and re-executes the
-  job. Note that a manual closing of the session is reuqired when running in jupyter notebook, since otherwise unncessary runtime on the IBM Quantum Machines might be a consequence.
+  job. **Important:** When using IBM Quantum backends or Sessions, it is **strongly recommended**
+  to use the :class:`Executor <squlearn.Executor>` within a context manager (``with`` statement) to ensure proper cleanup
+  and avoid unnecessary charges for open sessions. See :ref:`Session Management <session_management>` for details.
 - **Automatic backend selection (IBM Quantum only):** The :class:`Executor <squlearn.Executor>` class can automatically select the most suitable
   backend for the quantum job. The selection process is facilitated by the `mapomatic <https://github.com/qiskit-community/mapomatic>`_ tool `[1]`_.
   The :class:`Executor <squlearn.Executor>` can be initialized with a list of backends, a :class:`QiskitRuntimeService <qiskit_ibm_runtime.QiskitRuntimeService>`, or a Qiskit
@@ -148,18 +150,39 @@ execution environment:
 
 
 - A :class:`Backend <qiskit.providers.Backend>` from :class:`QiskitRuntimeService <qiskit_ibm_runtime.QiskitRuntimeService>`'s :meth:`backend <qiskit_ibm_runtime.QiskitRuntimeservice.backend>` method, which utilizes the execution of quantum jobs on IBM Quantum.
-  Sessions and Primitives are automatically created and managed by the :class:`Executor <squlearn.Executor>` class (remember to close the session at the end of your code when running on IBM Quantum).
+  Sessions and Primitives are automatically created and managed by the :class:`Executor <squlearn.Executor>` class.
+  
+  **Important:** Use the context manager to ensure the session is properly closed:
 
   .. code-block:: python
 
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
-    executor = Executor(service.backend('ibm_brisbane'))
-    ...
-    # Close the session at the end of your code
-    executor.close_session()
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    
+    # Recommended: Use context manager
+    with Executor(service.backend('ibm_kingston'), caching=True) as executor:
+        # Your quantum computations here
+        qnn.fit(X_train, y_train)
+    # Session is automatically closed
+
+  If you cannot use a context manager, remember to close the session at the end of your code:
+
+  .. code-block:: python
+
+    from squlearn import Executor
+    from qiskit_ibm_runtime import QiskitRuntimeService
+
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    executor = Executor(service.backend('ibm_kingston'))
+    try:
+        # Your quantum computations here
+        qnn.fit(X_train, y_train)
+    finally:
+        executor.close_session()
+
+  See :ref:`Session Management <session_management>` for details.
 
   It is also possible to pass a list of IBM Quantum backends from which the most suited backend is chosen
   automatically (see :ref:`Automatic backend selection <autoselect>`)
@@ -172,8 +195,12 @@ execution environment:
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
-    executor = Executor(service)
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    
+    # Use context manager for proper session management
+    with Executor(service, auto_backend_mode="quality") as executor:
+        # Your quantum computations here
+        qkrr.fit(X_train, y_train)
 
 - A pre-initialized :class:`Session <qiskit_ibm_runtime.Session>` object, which can be used to execute quantum jobs on the :class:`QiskitRuntimeService <qiskit_ibm_runtime.QiskitRuntimeService>`.
 
@@ -182,11 +209,13 @@ execution environment:
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
-    session = service.create_session(backend = service.backend('ibm_brisbane'))
-    executor = Executor(session)
-    ...
-    executor.close_session()
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    session = service.create_session(backend = service.backend('ibm_kingston'))
+    
+    # Use context manager with a pre-initialized session
+    with Executor(session) as executor:
+        # Your quantum computations here
+        qkrr.fit(X_train, y_train)
 
 - Pre-configured Primitive (:class:`Estimator <qiskit_ibm_runtime.Estimator>`, :class:`Sampler <qiskit_ibm_runtime.Sampler>`) with options for error mitigation.
   Note that the options from an :class:`Estimator <qiskit_ibm_runtime.Estimator>` are not automatically copied to
@@ -197,17 +226,17 @@ execution environment:
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService, Estimator
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
 
-    session = service.create_session(backend = service.backend('ibm_brisbane'))
+    session = service.create_session(backend = service.backend('ibm_kingston'))
     estimator = Estimator(session=session)
     estimator.options.resilience.zne_mitigation = True
     estimator.options.resilience.zne.noise_factors = (1, 3, 5)
     estimator.options.resilience.zne.extrapolator = "linear"
 
-    executor = Executor(estimator)
-    ...
-    executor.close_session()
+    with Executor(estimator) as executor:
+        # Your quantum computations here
+        qkrr.fit(X_train, y_train)
 
 
 - If only the ``backend.run`` execution is wanted, this can be achieved by utilizing the
@@ -231,22 +260,24 @@ backend from the :class:`QiskitRuntimeService <qiskit_ibm_runtime.QiskitRuntimeS
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
 
     options = {"resilience":{"zne_mitigation"  : True,
                              "zne":{"noise_factors" : (1, 3, 5),"extrapolator":"linear" }}
               }
 
-    executor = Executor(service.backend('ibm_brisbane'), # Specify the backend
-                         cache_dir='cache', # Set cache folder to "cache"
-                         caching=True, # Enable caching default for remote executions
-                         log_file="executor.log", # Set-up logging file
-                         wait_restart=600,  # Set 10 min pause between restarts of Jobs
-                         max_jobs_retries=10, # Set maximum number of restarts to 10 before aborting
-                         options_estimator=options # Set options for the Estimator primitive
-                         )
-
-    executor.set_shots(1234) # Shots can be adjusted after initialization
+    # Recommended: Use context manager
+    with Executor(service.backend('ibm_kingston'), # Specify the backend
+                   cache_dir='cache', # Set cache folder to "cache"
+                   caching=True, # Enable caching default for remote executions
+                   log_file="executor.log", # Set-up logging file
+                   wait_restart=600,  # Set 10 min pause between restarts of Jobs
+                   max_jobs_retries=10, # Set maximum number of restarts to 10 before aborting
+                   options_estimator=options # Set options for the Estimator primitive
+                   ) as executor:
+        executor.set_shots(1234) # Shots can be adjusted after initialization
+        # Your quantum computations here
+        qnn.fit(X_train, y_train)
 
 
 Utilizing Executor Primitives in Qiskit Routines
@@ -294,13 +325,15 @@ They folow the same dictionary datastructure than the original V2 Primtives.
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
 
     options = {"resilience":{"zne_mitigation"  : True,
                              "zne":{"noise_factors" : (1, 3, 5),"extrapolator":"linear" }}
               }
 
-    executor = Executor(service.backend("ibm_brisbane"),options_estimator=options)
+    with Executor(service.backend("ibm_kingston"), options_estimator=options) as executor:
+        # Your quantum computations here
+        pass
 
 Alternatively, the options can be adjusted by the attributes :meth:`estimator_options` and :meth:`sampler_options` similar
 to the option interface of the V2 Primtives:
@@ -310,10 +343,13 @@ to the option interface of the V2 Primtives:
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
-    executor = Executor(service.backend("ibm_brisbane"))
-    executor.sampler_options.dynamical_decoupling.enable = True
-    executor.sampler_options.dynamical_decoupling.sequence_type = "XpXm"
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    
+    with Executor(service.backend("ibm_kingston")) as executor:
+        executor.sampler_options.dynamical_decoupling.enable = True
+        executor.sampler_options.dynamical_decoupling.sequence_type = "XpXm"
+        # Your quantum computations here
+        pass
 
 Options can be adjusted by the :meth:`set_options` method of the Primitives that are created by the
 :class:`Executor <squlearn.Executor>` class.
@@ -323,11 +359,73 @@ Options can be adjusted by the :meth:`set_options` method of the Primitives that
     from squlearn import Executor
     from qiskit_ibm_runtime import QiskitRuntimeService, Options
 
-    service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
 
-    executor = Executor(service.backend("ibm_brisbane"))
-    estimator = executor.get_estimator()
-    estimator.set_options(resilience_level=2)
+    with Executor(service.backend("ibm_kingston")) as executor:
+        estimator = executor.get_estimator()
+        estimator.set_options(resilience_level=2)
+        # Your quantum computations here
+        pass
+
+.. _session_management:
+
+Session Management (IBM Quantum)
+--------------------------------
+
+When using the :class:`Executor <squlearn.Executor>` with IBM Quantum backends or Sessions, **proper session management is critical** to avoid:
+
+- Unnecessary open sessions consuming resources
+- Unexpected charges from IBM Quantum for unused sessions
+- Resource leaks in long-running applications
+
+**Recommended: Using Context Manager**
+
+The recommended way to use the :class:`Executor <squlearn.Executor>` with IBM Quantum backends is within a context manager (``with`` statement).
+This ensures that sessions are automatically closed when you exit the block, regardless of whether an error occurs:
+
+.. code-block:: python
+
+    from squlearn import Executor
+    from qiskit_ibm_runtime import QiskitRuntimeService
+
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    
+    # Recommended: Use context manager
+    with Executor(service.backend('ibm_kingston'), caching=True,
+                  cache_dir='cache', log_file="log.log") as executor:
+        # Your quantum computations here
+        qnn.fit(X_train, y_train)
+    # Session is automatically closed here
+
+**Alternative: Manual Session Closing**
+
+If you cannot use a context manager, you **must** manually close the session by calling :meth:`close_session` when done.
+A ``UserWarning`` will be issued if a session is created outside of a context manager context:
+
+.. code-block:: python
+
+    from squlearn import Executor
+    from qiskit_ibm_runtime import QiskitRuntimeService
+
+    service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+    executor = Executor(service.backend('ibm_kingston'))
+    
+    try:
+        # Your code here
+        qnn.fit(X_train, y_train)
+    finally:
+        # Make sure to close the session
+        executor.close_session()
+
+**Warning on Session Misuse**
+
+Creating a session outside of a context manager will issue a :class:`SessionContextMisuseWarning`. 
+This warning indicates that you should either:
+
+1. Use a context manager (recommended)
+2. Ensure you explicitly call :meth:`close_session` at the end
+
+Failing to do so may result in open sessions consuming resources and incurring charges on IBM Quantum.
 
 .. _autoselect:
 
@@ -400,16 +498,17 @@ the mode is switched to ``"speed"``. The :class:`Executor <squlearn.Executor>` i
 
    # Executor is initialized with a service, and considers all available backends
    # (except simulators)
-   service = QiskitRuntimeService(channel="ibm_quantum", token="INSERT_YOUR_TOKEN_HERE")
-   executor = Executor(service, auto_backend_mode="speed")
-
-   # Create a QKRR model with a FidelityKernel and the ChebyshevRx encoding circuit
-   qkrr = QKRR(FidelityKernel(ChebyshevRx(4),executor))
-
-   # Backend is automatically selected based on the smallest queue
-   # All the following functions will be executed on the selected backend
-   X_train, y_train = np.array([[0.1],[0.2]]), np.array([0.1,0.2])
-   qkrr.fit(X_train, y_train)
+   service = QiskitRuntimeService(channel="ibm_quantum_platform", token="INSERT_YOUR_TOKEN_HERE")
+   
+   # Use context manager for proper session management
+   with Executor(service, auto_backend_mode="speed") as executor:
+       # Create a QKRR model with a FidelityKernel and the ChebyshevRx encoding circuit
+       qkrr = QKRR(FidelityKernel(ChebyshevRx(4),executor))
+
+       # Backend is automatically selected based on the smallest queue
+       # All the following functions will be executed on the selected backend
+       X_train, y_train = np.array([[0.1],[0.2]]), np.array([0.1,0.2])
+       qkrr.fit(X_train, y_train)
 
 
 In-QPU parallelization (Qiskit only)