Refactor pygsp dependency

README.md

@@ -51,12 +51,14 @@ for the topological domains supported in [TopoNetX](https://github.com/pyt-team/
 `TopoEmbedX` is available on PyPI and can be installed using `pip`.
 
 ```bash
+pip install "pygsp @ git+https://github.com/epfl-lts2/pygsp@a3412ce7696c02c8a55439e89d0c9ab8ae863269"
 pip install "karateclub @ git+https://github.com/benedekrozemberczki/karateclub@cb46a91df8dcbeb2570debcf6a9d0c518107a2de"
 pip install topoembedx
 ```
 
-The library depends on `karateclub`, which did not receive updates on PyPI for a long time.
-You have to manually install the latest version from GitHub for up-to-date NetworkX compatibility.
+The library depends on `pygsp` and `karateclub`, which did not receive updates
+on PyPI for a long time. You have to manually install the latest versions from
+GitHub for up-to-date Python and NetworkX compatibility.
 
 ## 🦾 Getting Started
 
@@ -100,9 +102,10 @@ cd TopoEmbedX
 git pull
 ```
 
-3. Install a recent version of `karateclub`:
+3. Install a recent version of `pygsp` and `karateclub`:
 
 ```bash
+pip install "pygsp @ git+https://github.com/epfl-lts2/pygsp@a3412ce7696c02c8a55439e89d0c9ab8ae863269"
 pip install "karateclub @ git+https://github.com/benedekrozemberczki/karateclub@cb46a91df8dcbeb2570debcf6a9d0c518107a2de"
 ```
 

docs/index.rst

@@ -30,11 +30,13 @@ for the topological domains supported in `TopoNetX <https://github.com/pyt-team/
 
 .. code-block:: bash
 
+   pip install "pygsp @ git+https://github.com/epfl-lts2/pygsp@a3412ce7696c02c8a55439e89d0c9ab8ae863269"
    pip install "karateclub @ git+https://github.com/benedekrozemberczki/karateclub@cb46a91df8dcbeb2570debcf6a9d0c518107a2de"
    pip install topoembedx
 
-The library depends on ``karateclub``, which did not receive updates on PyPI for a long time.
-You have to manually install the latest version from GitHub for up-to-date NetworkX compatibility.
+The library depends on ``pygsp`` and ``karateclub``, which did not receive
+updates on PyPI for a long time. You have to manually install the latest
+versions from GitHub for up-to-date Python and NetworkX compatibility.
 
 🔍 References
 -------------

pyproject.toml

@@ -39,10 +39,10 @@ dependencies=[
     "scipy",
     "toponetx",
 
-    # We don't have a direct dependency on pygsp, but it is required by karateclub.
-    # The version on PyPI is severely outdated and does not work on Python 3.12.
-    # At least using the latest version from GitHub works for now.
-    "pygsp @ git+https://github.com/epfl-lts2/pygsp@a3412ce7696c02c8a55439e89d0c9ab8ae863269"
+    # These dependencies did not receive a new release on PyPI for a long time.
+    # We ask the user to manually install the latest version from GitHub separately.
+    "karateclub",
+    "pygsp"
 ]
 
 [project.optional-dependencies]