Merge pull request #7 from hanno-meister/gp_multi_choice_decision

parallel ReAct agent

Author: YoanSallami

.gitignore

@@ -1,171 +1,138 @@
-# Byte-compiled / optimized / DLL files
+# byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
 *$py.class
 
 # C extensions
 *.so
 
-# Distribution / packaging
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# Cython debug symbols
+cython_debug/
+
+# distribution / packaging
+.eggs/
+.installed.cfg
 .Python
+*.egg
+*.egg-info/
 build/
 develop-eggs/
 dist/
 downloads/
 eggs/
-.eggs/
 lib/
 lib64/
+MANIFEST
 parts/
 sdist/
+share/python-wheels/
 var/
 wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
 
-# Django stuff:
+# Django
 *.log
-local_settings.py
 db.sqlite3
 db.sqlite3-journal
+local_settings.py
 
-# Flask stuff:
-instance/
-.webassets-cache
+# environments
+.env
+.venv
+env.bak/
+env/
+ENV/
+venv.bak/
+venv/
 
-# Scrapy stuff:
-.scrapy
+# Flask
+.webassets-cache
+instance/
 
-# Sphinx documentation
-docs/_build/
+# IDEs
+.idea/
+.vscode/
 
-# PyBuilder
-.pybuilder/
-target/
+# IPython
+ipython_config.py
+profile_default/
 
-# Jupyter Notebook
+# Jupyter
 .ipynb_checkpoints
 
-# IPython
-profile_default/
-ipython_config.py
+# logging
+pip-delete-this-directory.txt
+pip-log.txt
 
-# pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
-
-# pipenv
-#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-#   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
-#Pipfile.lock
-
-# UV
-#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#uv.lock
-
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
+# macOS system files
+.DS_Store
+
+# mkdocs documentation
+/site
 
 # pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#pdm.lock
-#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
-#   in version control.
+#   pdm stores project-wide configurations in .pdm.toml,
+#   but it is recommended to not include it in version control.
 #   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
-.pdm.toml
-.pdm-python
 .pdm-build/
+.pdm-python
+.pdm.toml
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
 
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
+# PyBuilder
+.pybuilder/
+target/
+
+# PyInstaller
+*.manifest
+*.spec
+
+# PyPI configuration file
+.pypirc
+
+# Rope settings
+.ropeproject
 
 # SageMath parsed files
 *.sage.py
 
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
+# Scrapy
+.scrapy
+
+# Sphinx documentation
+docs/_build/
 
-# Spyder project settings
+# Spyder settings
 .spyderproject
 .spyproject
 
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
+# static analysis
 .dmypy.json
-dmypy.json
-
-# Pyre type checker
+.mypy_cache/
 .pyre/
-
-# pytype static type analyzer
 .pytype/
+dmypy.json
 
-# Cython debug symbols
-cython_debug/
-
-# PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+# testing
+.cache
+.coverage
+.coverage.*
+.hypothesis/
+.nox/
+.pytest_cache/
+.tox/
+*.cover
+*.py,cover
+cover/
+coverage.xml
+htmlcov/
+nosetests.xml
 
-# PyPI configuration file
-.pypirc
+# translations
+*.mo
+*.pot

README.md

@@ -1,4 +1,3 @@
-
 <div align="center">
 <img height=200 src="https://github.com/SynaLinks/synalinks/blob/main/img/synalinks_logo_square.png?raw=true">
 </div>
@@ -439,4 +438,4 @@ Synalinks would not be possible without the great work of the following open-sou
 - [Keras](https://keras.io/) for the graph-based computation backbone, API and overall code, design and philosophy.
 - [DSPy](https://dspy.ai/) for the modules/optimizers inspiration.
 - [Pydantic](https://docs.pydantic.dev/latest/) for the backend data layer.
-- [LiteLLM](https://docs.litellm.ai/docs/) for the LMs integrations.
+- [LiteLLM](https://docs.litellm.ai/docs/) for the LMs integrations.

coverage-badge.svg

@@ -0,0 +1,2 @@
+
+::: synalinks.src.modules.agents.parallel_react_agent

docs/Synalinks API/Modules API/Agents Modules/Parallel ReACT Agent module.md

@@ -84,4 +84,5 @@ if __name__ == "__main__":
 
 ### Agents Modules
 
-- [ReACT Agent module](Agents Modules/ReACT Agent module.md)
+- [ReACT Agent module](Agents Modules/ReACT Agent module.md)
+- [Parallel ReACT Agent module](Agents Modules/Parallel ReACT Agent module.md)

docs/Synalinks API/Modules API/index.md

@@ -116,6 +116,7 @@ nav:
       - Agents Modules:
         - Synalinks API/Modules API/Agents Modules/index.md
         - Synalinks API/Modules API/Agents Modules/ReACT Agent module.md
+        - Synalinks API/Modules API/Agents Modules/Parallel ReACT Agent module.md
     - Callbacks API:
       - Synalinks API/Callbacks API/index.md
       - Synalinks API/Callbacks API/Base Callback class.md

mkdocs.yml

@@ -22,22 +22,22 @@ classifiers = [
 dependencies = [
     "absl-py",
     "asyncio",
+    "click",
     "datasets",
+    "docstring-parser",
+    "graphviz",
+    "inquirer",
     "jinja2",
     "litellm",
+    "matplotlib",
     "namex",
+    "neo4j",
+    "nest-asyncio",
     "numpy",
     "optree",
     "pydantic",
     "pydotplus",
     "rich",
-    "matplotlib",
-    "docstring-parser",
-    "nest-asyncio",
-    "graphviz",
-    "click",
-    "inquirer",
-    "neo4j",
     "sentry-sdk",
 ]
 

pyproject.toml

@@ -33,9 +33,11 @@
 from synalinks.api import LanguageModel
 from synalinks.api import Metric
 from synalinks.api import Module
+from synalinks.api import MultiDecision
 from synalinks.api import Not
 from synalinks.api import Operation
 from synalinks.api import Or
+from synalinks.api import ParallelReACTAgent
 from synalinks.api import Prediction
 from synalinks.api import Program
 from synalinks.api import ReACTAgent
@@ -44,6 +46,7 @@
 from synalinks.api import Reward
 from synalinks.api import SelfCritique
 from synalinks.api import Sequential
+from synalinks.api import SequentialReACTAgent
 from synalinks.api import SimilaritySearch
 from synalinks.api import StatelessScope
 from synalinks.api import SymbolicDataModel

synalinks/__init__.py

@@ -72,7 +72,11 @@
 from synalinks.src.knowledge_bases.knowledge_base import KnowledgeBase as KnowledgeBase
 from synalinks.src.language_models.language_model import LanguageModel as LanguageModel
 from synalinks.src.metrics.metric import Metric as Metric
+from synalinks.src.modules.agents.parallel_react_agent import (
+    ParallelReACTAgent as ParallelReACTAgent,
+)
 from synalinks.src.modules.agents.react_agent import ReACTAgent as ReACTAgent
+from synalinks.src.modules.agents.react_agent import ReACTAgent as SequentialReACTAgent
 from synalinks.src.modules.core.action import Action as Action
 from synalinks.src.modules.core.branch import Branch as Branch
 from synalinks.src.modules.core.decision import Decision as Decision
@@ -85,6 +89,7 @@
 )
 from synalinks.src.modules.core.identity import Identity as Identity
 from synalinks.src.modules.core.input_module import Input as Input
+from synalinks.src.modules.core.multi_decision import MultiDecision as MultiDecision
 from synalinks.src.modules.core.not_module import Not as Not
 from synalinks.src.modules.knowledge.embedding import Embedding as Embedding
 from synalinks.src.modules.knowledge.entity_retriever import (

synalinks/api/__init__.py

@@ -6,14 +6,19 @@
 
 from synalinks.src.modules import deserialize as deserialize
 from synalinks.src.modules import serialize as serialize
+from synalinks.src.modules.agents.parallel_react_agent import (
+    ParallelReACTAgent as ParallelReACTAgent,
+)
 from synalinks.src.modules.agents.react_agent import ReACTAgent as ReACTAgent
+from synalinks.src.modules.agents.react_agent import ReACTAgent as SequentialReACTAgent
 from synalinks.src.modules.core.action import Action as Action
 from synalinks.src.modules.core.branch import Branch as Branch
 from synalinks.src.modules.core.decision import Decision as Decision
 from synalinks.src.modules.core.generator import Generator as Generator
 from synalinks.src.modules.core.identity import Identity as Identity
 from synalinks.src.modules.core.input_module import Input as Input
 from synalinks.src.modules.core.input_module import InputModule as InputModule
+from synalinks.src.modules.core.multi_decision import MultiDecision as MultiDecision
 from synalinks.src.modules.core.not_module import Not as Not
 from synalinks.src.modules.knowledge.embedding import Embedding as Embedding
 from synalinks.src.modules.knowledge.entity_retriever import (