waldiez 0.4.3__py3-none-any.whl → 0.4.5__py3-none-any.whl

waldiez/models/waldiez.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: Apache-2.0.
 # Copyright (c) 2024 - 2025 Waldiez and contributors.
-"""Waldiez
+"""Waldiez data class.
 
 A Waldiez class contains all the information that is needed to generate
 and run an autogen workflow. It has the model/LLM configurations, the agent
@@ -167,7 +167,7 @@ class Waldiez:
         """Get the agents.
 
         Yields
-        -------
+        ------
         WaldiezAgent
             The flow agents.
         """
@@ -178,7 +178,7 @@ class Waldiez:
         """Get the flow skills.
 
         Yields
-        -------
+        ------
         WaldiezSkill
             The skills.
         """
@@ -189,7 +189,7 @@ class Waldiez:
         """Get the models.
 
         Yields
-        -------
+        ------
         WaldiezModel
             The flow models.
         """
@@ -276,7 +276,7 @@ class Waldiez:
                 autogen_version=autogen_version,
             )
         )
-        return sorted(list(requirements))
+        return sorted(requirements)
 
     def get_flow_env_vars(self) -> List[Tuple[str, str]]:
         """Get the flow environment variables.

waldiez/runner.py

@@ -1,6 +1,7 @@
 # SPDX-License-Identifier: Apache-2.0.
 # Copyright (c) 2024 - 2025 Waldiez and contributors.
 """Run a waldiez flow.
+
 The flow is first converted to an autogen flow with agents, chats and skills.
 We then chown to temporary directory, call the flow's `main()` and
 return the results. Before running the flow, any additional environment
@@ -144,9 +145,9 @@ class WaldiezRunner:
         Set[str]
             The extra requirements.
         """
-        extra_requirements = set(
+        extra_requirements = {
             req for req in self.waldiez.requirements if req not in sys.modules
-        )
+        }
         if self.waldiez.has_captain_agents:
             check_pysqlite3()
         return extra_requirements
@@ -185,6 +186,7 @@ class WaldiezRunner:
             The runtime uploads root.
         skip_mmd : bool
             Whether to skip the Mermaid diagram generation.
+
         Returns
         -------
         Union[ChatResult, List[ChatResult]]

waldiez/running/environment.py

@@ -3,7 +3,7 @@
 # pylint: disable=import-outside-toplevel,reimported
 """Environment related utilities."""
 
-import importlib.util
+import importlib
 import os
 import site
 import sys
@@ -20,7 +20,8 @@ def in_virtualenv() -> bool:
         True if inside a virtualenv, False otherwise.
     """
     return hasattr(sys, "real_prefix") or (
-        hasattr(sys, "base_prefix") and sys.base_prefix != sys.prefix
+        hasattr(sys, "base_prefix")
+        and os.path.realpath(sys.base_prefix) != os.path.realpath(sys.prefix)
     )
 
 
@@ -69,7 +70,7 @@ def refresh_environment() -> None:
 
             @contextlib.contextmanager
             def _np_no_nep50_warning() -> Generator[None, None, None]:
-                """Dummy function to avoid the warning.
+                """Avoid no_nep50 warning.
 
                 Yields
                 ------

waldiez/running/gen_seq_diagram.py

@@ -69,12 +69,12 @@ def process_events(df_events: pd.DataFrame) -> str:
     ----------
     df_events : pd.DataFrame
         The DataFrame containing the events data.
+
     Returns
     -------
     str
         The Mermaid sequence diagram text.
     """
-
     # Set to store participants (senders and recipients)
     participants: Set[str] = set()
     recipient: str
@@ -150,7 +150,7 @@ def save_diagram(mermaid_text: str, output_path: Union[str, Path]) -> None:
 def generate_sequence_diagram(
     file_path: Union[str, Path], output_path: Union[str, Path]
 ) -> None:
-    """Main function to generate the Mermaid diagram.
+    """Generate the Mermaid diagram.
 
     Parameters
     ----------
@@ -163,6 +163,7 @@ def generate_sequence_diagram(
     ------
     FileNotFoundError
         If the input file is not found.
+
     ValueError
         If the input file is not a JSON or CSV file.
     """

waldiez/running/running.py

@@ -120,20 +120,34 @@ def install_requirements(
     requirements_string = ", ".join(extra_requirements)
     printer(f"Installing requirements: {requirements_string}")
     pip_install = [sys.executable, "-m", "pip", "install"]
-    if not in_virtualenv():
+    if not in_virtualenv():  # it should
+        # if not, let's try to install as user
+        # not sure if --break-system-packages is safe
+        # but it might fail if we don't
+        break_system_packages = os.environ.get("PIP_BREAK_SYSTEM_PACKAGES", "")
+        os.environ["PIP_BREAK_SYSTEM_PACKAGES"] = "1"
         pip_install.append("--user")
     pip_install.extend(extra_requirements)
-    with subprocess.Popen(
-        pip_install,
-        stdout=subprocess.PIPE,
-        stderr=subprocess.PIPE,
-    ) as proc:
-        if proc.stdout:
-            for line in io.TextIOWrapper(proc.stdout, encoding="utf-8"):
-                printer(line.strip())
-        if proc.stderr:
-            for line in io.TextIOWrapper(proc.stderr, encoding="utf-8"):
-                printer(line.strip())
+    # pylint: disable=too-many-try-statements
+    try:
+        with subprocess.Popen(
+            pip_install,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+        ) as proc:
+            if proc.stdout:
+                for line in io.TextIOWrapper(proc.stdout, encoding="utf-8"):
+                    printer(line.strip())
+            if proc.stderr:
+                for line in io.TextIOWrapper(proc.stderr, encoding="utf-8"):
+                    printer(line.strip())
+    finally:
+        if not in_virtualenv():
+            # restore the old env var
+            if break_system_packages:
+                os.environ["PIP_BREAK_SYSTEM_PACKAGES"] = break_system_packages
+            else:
+                del os.environ["PIP_BREAK_SYSTEM_PACKAGES"]
 
 
 async def a_install_requirements(
@@ -152,19 +166,29 @@ async def a_install_requirements(
     printer(f"Installing requirements: {requirements_string}")
     pip_install = [sys.executable, "-m", "pip", "install"]
     if not in_virtualenv():
-        pip_install.extend(["--user", "--break-system-packages"])
+        break_system_packages = os.environ.get("PIP_BREAK_SYSTEM_PACKAGES", "")
+        os.environ["PIP_BREAK_SYSTEM_PACKAGES"] = "1"
+        pip_install.extend(["--user"])
     pip_install.extend(extra_requirements)
-    proc = await asyncio.create_subprocess_exec(
-        *pip_install,
-        stdout=asyncio.subprocess.PIPE,
-        stderr=asyncio.subprocess.PIPE,
-    )
-    if proc.stdout:
-        async for line in proc.stdout:
-            printer(line.decode().strip())
-    if proc.stderr:
-        async for line in proc.stderr:
-            printer(line.decode().strip())
+    # pylint: disable=too-many-try-statements
+    try:
+        proc = await asyncio.create_subprocess_exec(
+            *pip_install,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+        if proc.stdout:
+            async for line in proc.stdout:
+                printer(line.decode().strip())
+        if proc.stderr:
+            async for line in proc.stderr:
+                printer(line.decode().strip())
+    finally:
+        if not in_virtualenv():
+            if break_system_packages:
+                os.environ["PIP_BREAK_SYSTEM_PACKAGES"] = break_system_packages
+            else:
+                del os.environ["PIP_BREAK_SYSTEM_PACKAGES"]
 
 
 def after_run(

waldiez/utils/check_rdps.py

@@ -0,0 +1,18 @@
+# SPDX-License-Identifier: Apache-2.0.
+# Copyright (c) 2024 - 2025 Waldiez and contributors.
+"""
+Check for rpds-py on Windows ARM64.
+
+Since we cannot use direct git dependency on `rpds-py` in `pyproject.toml`,
+let's check it here.
+
+NOTE: We should regularly check if this is still needed.
+"""
+# "rpds-py @ git+https://github.com/crate-py/rpds.git@v0.24.0 ;
+# sys_platform == "win32" and platform_machine == "arm64"",
+# "rpds-py @ git+https://github.com/crate-py/rpds.git@v0.24.0 ;
+# sys_platform == "win32" and platform_machine == "ARM64"",
+# "rpds-py @ git+https://github.com/crate-py/rpds.git@v0.24.0 ;
+# sys_platform == "win32" and platform_machine == "aarch64"",
+# "rpds-py @ git+https://github.com/crate-py/rpds.git@v0.24.0 ;
+# sys_platform == "win32" and platform_machine == "AARCH64"",

waldiez/utils/cli_extras/__init__.py

@@ -7,6 +7,7 @@
 import typer
 
 from .jupyter import add_jupyter_cli
+from .runner import add_runner_cli
 from .studio import add_studio_cli
 
 
@@ -24,6 +25,7 @@ def add_cli_extras(app: typer.Typer) -> None:
         The app with the extra commands added
     """
     add_jupyter_cli(app)
+    add_runner_cli(app)
     add_studio_cli(app)
 
 

waldiez/utils/cli_extras/runner.py

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0.
+# Copyright (c) 2024 - 2025 Waldiez and contributors.
+# pylint: skip-file
+# isort: skip_file
+# flake8: noqa: E501,E402
+"""Waldiez-runner extra typer commands for CLI."""
+
+from typing import Any, Callable
+
+import typer
+from typer.models import CommandInfo
+
+HAVE_RUNNER = False
+runner_app: Callable[..., Any] | None = None
+
+try:
+    from waldiez_runner.cli import run  # type: ignore[unused-ignore, import-not-found, import-untyped]
+
+    runner_app = run
+
+    HAVE_RUNNER = True
+except BaseException:
+    pass
+
+
+def add_runner_cli(app: typer.Typer) -> None:
+    """Add runner command to the app if available.
+
+    Parameters
+    ----------
+    app : typer.Typer
+        The Typer app to add the runner command to.
+    """
+    if HAVE_RUNNER:
+        app.registered_commands.append(
+            CommandInfo(name="serve", callback=runner_app)
+        )

{waldiez-0.4.3.dist-info → waldiez-0.4.5.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: waldiez
-Version: 0.4.3
-Summary: waldiez
-Project-URL: homepage, https://waldiez.io
-Project-URL: repository, https://github.com/waldiez/python.git
-Project-URL: documentation, https://waldiez.github.io/python/
-Project-URL: issues, https://github.com/waldiez/python/issues
-Author-email: Panagiotis Kasnesis <pkasnesis@waldiez.io>, Lazaros Toumanidis <laztoum@waldiez.io>, Stella Ioannidou <stella@humancentered.gr>
+Version: 0.4.5
+Dynamic: Keywords
+Summary: Make AI Agents Collaborate: Drag, Drop, and Orchestrate with Waldiez.
+Project-URL: Homepage, https://waldiez.io
+Project-URL: Bug Tracker, https://github.com/waldiez/waldiez/issues
+Project-URL: Repository, https://github.com/waldiez/waldiez.git
+Author-email: Panagiotis Kasnesis <pkasnesis@waldiez.io>, Lazaros Toumanidis <laztoum@waldiez.io>, Stella Ioannidou <stella@waldiez.io>
 License-File: LICENSE
 License-File: NOTICE.md
 Classifier: Development Status :: 3 - Alpha
@@ -28,20 +28,27 @@ Requires-Dist: asyncer==0.0.8
 Requires-Dist: graphviz==0.20.3
 Requires-Dist: httpx<1
 Requires-Dist: jupytext
-Requires-Dist: numpy<=2.2.4
+Requires-Dist: nest-asyncio==1.6.0
+Requires-Dist: numpy<=2.2.5
 Requires-Dist: pandas>=2
 Requires-Dist: parso==0.8.4
-Requires-Dist: pyautogen[openai]==0.8.6
+Requires-Dist: pyautogen[openai]==0.8.7
 Requires-Dist: pydantic<3,>=2.10.2
 Requires-Dist: typer<0.16,>=0.9
 Provides-Extra: ag2-extras
 Requires-Dist: beautifulsoup4; extra == 'ag2-extras'
-Requires-Dist: chromadb>=0.5.10; extra == 'ag2-extras'
-Requires-Dist: embedchain; extra == 'ag2-extras'
+Requires-Dist: chromadb>=0.5.10; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: chromadb>=0.5.10; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: embedchain; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: embedchain; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: google-api-python-client<3.0,>=2.163.0; extra == 'ag2-extras'
+Requires-Dist: google-auth-httplib2<0.3,>=0.2.0; extra == 'ag2-extras'
+Requires-Dist: google-auth-oauthlib<2.0,>=1.2.1; extra == 'ag2-extras'
 Requires-Dist: huggingface-hub; extra == 'ag2-extras'
 Requires-Dist: ipython; extra == 'ag2-extras'
 Requires-Dist: langchain-community<1,>=0.3.12; extra == 'ag2-extras'
 Requires-Dist: markdownify; extra == 'ag2-extras'
+Requires-Dist: mcp<1.6,>=1.4.0; extra == 'ag2-extras'
 Requires-Dist: pgvector>=0.4.0; extra == 'ag2-extras'
 Requires-Dist: protobuf>=4.25.3; extra == 'ag2-extras'
 Requires-Dist: psycopg==3.2.6; (sys_platform == 'linux') and extra == 'ag2-extras'
@@ -49,59 +56,73 @@ Requires-Dist: psycopg==3.2.6; (sys_platform == 'win32' and platform_machine ==
 Requires-Dist: psycopg==3.2.6; (sys_platform == 'win32' and platform_machine == 'ARM64') and extra == 'ag2-extras'
 Requires-Dist: psycopg==3.2.6; (sys_platform == 'win32' and platform_machine == 'aarch64') and extra == 'ag2-extras'
 Requires-Dist: psycopg==3.2.6; (sys_platform == 'win32' and platform_machine == 'arm64') and extra == 'ag2-extras'
+Requires-Dist: psycopg>=3.2.6; (sys_platform == 'win32') and extra == 'ag2-extras'
 Requires-Dist: psycopg[binary]==3.2.6; (sys_platform != 'linux' and platform_machine != 'arm64' and platform_machine != 'ARM64' and platform_machine != 'aarch64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: psycopg[binary]>=3.2.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[anthropic]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[bedrock]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[cohere]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[gemini]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[groq]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[interop-crewai]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[interop-langchain]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[lmm]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[mistral]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[neo4j]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[ollama]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[together]==0.8.6; extra == 'ag2-extras'
-Requires-Dist: pyautogen[websurfer]==0.8.6; extra == 'ag2-extras'
+Requires-Dist: psycopg[binary]>=3.2.6; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[anthropic]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[bedrock]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[cohere]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[gemini]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[gemini]==0.8.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[groq]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[interop-crewai]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[interop-langchain]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[lmm]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[mistral]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[neo4j]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[neo4j]==0.8.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[ollama]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: pyautogen[together]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[together]==0.8.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: pyautogen[websurfer]==0.8.7; extra == 'ag2-extras'
 Requires-Dist: pydantic-ai>=0.0.21; extra == 'ag2-extras'
 Requires-Dist: pymongo>=4.11; extra == 'ag2-extras'
 Requires-Dist: pypdf; extra == 'ag2-extras'
 Requires-Dist: pysqlite3-binary==0.5.4; (sys_platform == 'linux' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: qdrant-client[fastembed]; extra == 'ag2-extras'
-Requires-Dist: sentence-transformers; extra == 'ag2-extras'
+Requires-Dist: qdrant-client[fastembed]; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: qdrant-client[fastembed]; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: sentence-transformers; (sys_platform == 'linux') and extra == 'ag2-extras'
+Requires-Dist: wikipedia-api<1.0,>=0.8.1; extra == 'ag2-extras'
 Provides-Extra: dev
 Requires-Dist: autoflake==2.3.1; extra == 'dev'
 Requires-Dist: bandit==1.8.3; extra == 'dev'
 Requires-Dist: black[jupyter]==25.1.0; extra == 'dev'
 Requires-Dist: flake8==7.2.0; extra == 'dev'
-Requires-Dist: isort==6.0.1; extra == 'dev'
+Requires-Dist: hatchling==1.27.0; extra == 'dev'
+Requires-Dist: jupyter-server==2.15.0; extra == 'dev'
+Requires-Dist: jupyterlab>=4.3.0; extra == 'dev'
 Requires-Dist: mypy==1.15.0; extra == 'dev'
 Requires-Dist: pandas-stubs==2.2.3.250308; extra == 'dev'
 Requires-Dist: pre-commit==4.2.0; extra == 'dev'
 Requires-Dist: pydocstyle==6.3.0; extra == 'dev'
 Requires-Dist: pylint==3.3.6; extra == 'dev'
 Requires-Dist: python-dotenv==1.1.0; extra == 'dev'
-Requires-Dist: ruff==0.11.5; extra == 'dev'
+Requires-Dist: ruff==0.11.7; extra == 'dev'
 Requires-Dist: toml==0.10.2; (python_version <= '3.10') and extra == 'dev'
 Requires-Dist: types-pyyaml==6.0.12.20250402; extra == 'dev'
+Requires-Dist: types-requests==2.32.0.20250328; extra == 'dev'
 Requires-Dist: types-toml==0.10.8.20240310; extra == 'dev'
 Requires-Dist: yamllint==1.37.0; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mdx-include==1.4.2; extra == 'docs'
 Requires-Dist: mdx-truly-sane-lists==1.3; extra == 'docs'
+Requires-Dist: mkdocs-awesome-nav; extra == 'docs'
 Requires-Dist: mkdocs-jupyter==0.25.1; extra == 'docs'
 Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == 'docs'
-Requires-Dist: mkdocs-material==9.6.11; extra == 'docs'
+Requires-Dist: mkdocs-material==9.6.12; extra == 'docs'
 Requires-Dist: mkdocs-minify-html-plugin==0.3.1; extra == 'docs'
+Requires-Dist: mkdocs-open-in-new-tab==1.0.8; extra == 'docs'
 Requires-Dist: mkdocs==1.6.1; extra == 'docs'
 Requires-Dist: mkdocstrings-python==1.16.10; extra == 'docs'
 Requires-Dist: mkdocstrings[crystal,python]==0.29.1; extra == 'docs'
 Provides-Extra: jupyter
+Requires-Dist: jupyter-server==2.15.0; extra == 'jupyter'
 Requires-Dist: jupyterlab>=4.3.0; extra == 'jupyter'
-Requires-Dist: waldiez-jupyter==0.4.3; extra == 'jupyter'
+Requires-Dist: waldiez-jupyter==0.4.5; extra == 'jupyter'
+Provides-Extra: runner
+Requires-Dist: waldiez-runner==0.4.5; (python_version >= '3.11') and extra == 'runner'
 Provides-Extra: studio
-Requires-Dist: waldiez-studio==0.4.3; extra == 'studio'
+Requires-Dist: waldiez-studio==0.4.5; extra == 'studio'
 Provides-Extra: test
 Requires-Dist: pytest-asyncio==0.26.0; extra == 'test'
 Requires-Dist: pytest-cov==6.1.1; extra == 'test'
@@ -114,7 +135,7 @@ Description-Content-Type: text/markdown
 
 # Waldiez
 
-![CI Build](https://github.com/waldiez/python/actions/workflows/main.yaml/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/waldiez/python/badge.svg)](https://coveralls.io/github/waldiez/python) [![PyPI version](https://badge.fury.io/py/waldiez.svg?icon=si%3Apython)](https://badge.fury.io/py/waldiez)
+![CI Build](https://github.com/waldiez/python/actions/workflows/main.yaml/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/waldiez/python/badge.svg)](https://coveralls.io/github/waldiez/python) [![PyPI version](https://badge.fury.io/py/waldiez.svg?icon=si%3Apython)](https://badge.fury.io/py/waldiez) [![npm version](https://badge.fury.io/js/@waldiez%2Freact.svg)](https://badge.fury.io/js/@waldiez%2Freact)
 
 Translate a Waldiez flow:
 
@@ -130,16 +151,36 @@ To a python script or a jupyter notebook with the corresponding [ag2](https://gi
 
 ## Installation
 
+### Python
+
 On PyPI:
 
-```bash
+```shell
 python -m pip install waldiez
 ```
 
 From the repository:
 
-```bash
-python -m pip install git+https://github.com/waldiez/python.git
+```shell
+python -m pip install git+https://github.com/waldiez/waldiez.git
+```
+
+### React Component
+
+If you’re looking for the React component, please refer to [README.npm](https://github.com/waldiez/waldiez/blob/main/README.npm.md).
+
+> Note: The React component is only for creating and editing flows — it is not needed to convert or run flows (that functionality is handled by the Python package).
+
+Quick install:
+
+```shell
+npm install @waldiez/react
+# or
+yarn add @waldiez/react
+# or
+pnpm add @waldiez/react
+# or
+bun add @waldiez/react
 ```
 
 ## Usage
@@ -147,7 +188,6 @@ python -m pip install git+https://github.com/waldiez/python.git
 ### UI Options
 
 - For creating-only (no exporting or running) waldiez flows, you can use the playground at <https://waldiez.github.io>.
-The repo for the js library is [here](https://github.com/waldiez/react).
 - There is also a jupyterlab extension [here](https://github.com/waldiez/jupyter)
 - You also can use the vscode extension:
   - [repo](https://github.com/waldiez/vscode)
@@ -250,6 +290,47 @@ runner.run(output_path=output_path)
   pip install --force --no-cache waldiez pyautogen
   ```
 
+## See also
+
+- [Waldiez Playground](https://waldiez.github.io)
+- [React Component](https://github.com/waldiez/waldiez/blob/main/README.npm.md)
+- [Waldiez Studio](https://github.com/waldiez/studio)
+- [Waldiez JupyterLab Extension](htttps://github.com/waldiez/jupyter)
+- [Waldiez VSCode Extension](https://github.com/waldiez/vscode)
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://scholar.google.com/citations?user=JmW9DwkAAAAJ"><img src="https://avatars.githubusercontent.com/u/29335277?v=4?s=100" width="100px;" alt="Panagiotis Kasnesis"/><br /><sub><b>Panagiotis Kasnesis</b></sub></a><br /><a href="#projectManagement-ounospanas" title="Project Management">📆</a> <a href="#research-ounospanas" title="Research">🔬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://humancentered.gr/"><img src="https://avatars.githubusercontent.com/u/3456066?v=4?s=100" width="100px;" alt="Stella Ioannidou"/><br /><sub><b>Stella Ioannidou</b></sub></a><br /><a href="#promotion-siioannidou" title="Promotion">📣</a> <a href="#design-siioannidou" title="Design">🎨</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/lazToum"><img src="https://avatars.githubusercontent.com/u/4764837?v=4?s=100" width="100px;" alt="Lazaros Toumanidis"/><br /><sub><b>Lazaros Toumanidis</b></sub></a><br /><a href="https://github.com/waldiez/react/commits?author=lazToum" title="Code">💻</a></td>
+    </tr>
+  </tbody>
+  <tfoot>
+    <tr>
+      <td align="center" size="13px" colspan="7">
+        <img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
+          <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
+        </img>
+      </td>
+    </tr>
+  </tfoot>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
 ## License
 
-This project is licensed under the [Apache License, Version 2.0 (Apache-2.0)](https://github.com/waldiez/python/blob/main/LICENSE).
+This project is licensed under the [Apache License, Version 2.0 (Apache-2.0)](https://github.com/waldiez/waldiez/blob/main/LICENSE).