waldiez 0.4.7__py3-none-any.whl → 0.4.9__py3-none-any.whl

waldiez/utils/version.py

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: Apache-2.0.
+# Copyright (c) 2024 - 2025 Waldiez and contributors.
+"""Try to get the Waldiez version."""
+
+import json
+from pathlib import Path
+
+
+def _get_waldiez_version_from_package_json() -> str | None:
+    """Get the Waldiez version from package.json."""
+    package_json_path = Path(__file__).parent.parent.parent / "package.json"
+    if package_json_path.exists():
+        with open(package_json_path, "r", encoding="utf-8") as f:
+            package_data = json.load(f)
+            return package_data.get("version", None)
+    return None
+
+
+def _get_waldiez_version_from_version_py() -> str | None:
+    """Get the Waldiez version from _version.py."""
+    version_py_path = Path(__file__).parent.parent / "_version.py"
+    if version_py_path.exists():
+        with open(version_py_path, "r", encoding="utf-8") as f:
+            for line in f:
+                if line.startswith("__version__"):
+                    return line.split('"')[1]
+    return None
+
+
+def get_waldiez_version() -> str:
+    """Get the Waldiez version.
+
+    Returns
+    -------
+    str
+        The Waldiez version, or "dev" if not found.
+    """
+    w_version = _get_waldiez_version_from_package_json()
+    if not w_version:
+        w_version = _get_waldiez_version_from_version_py()
+    if not w_version:
+        w_version = "dev"
+    return w_version
+
+
+if __name__ == "__main__":
+    print(get_waldiez_version())

{waldiez-0.4.7.dist-info → waldiez-0.4.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: waldiez
-Version: 0.4.7
+Version: 0.4.9
 Dynamic: Keywords
 Summary: Make AG2 Agents Collaborate: Drag, Drop, and Orchestrate with Waldiez.
 Project-URL: Homepage, https://waldiez.io
@@ -9,8 +9,10 @@ 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
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pydantic :: 2
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
@@ -20,132 +22,175 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.10
-Requires-Dist: ag2[openai]==0.8.7
+Requires-Dist: ag2[openai]==0.9.2
 Requires-Dist: aiocsv==1.3.2
 Requires-Dist: aiofiles==24.1.0
 Requires-Dist: aiosqlite==0.21.0
 Requires-Dist: asyncer==0.0.8
-Requires-Dist: graphviz==0.20.3
+Requires-Dist: click<8.2
+Requires-Dist: graphviz<=0.20.3
 Requires-Dist: httpx<1
 Requires-Dist: jupytext
 Requires-Dist: nest-asyncio==1.6.0
-Requires-Dist: numpy<=2.2.5
+Requires-Dist: numpy<=2.3.0
 Requires-Dist: pandas>=2
 Requires-Dist: parso==0.8.4
-Requires-Dist: pillow>=10.0.0
+Requires-Dist: pillow
+Requires-Dist: pip>=25
 Requires-Dist: pydantic<3,>=2.10.2
-Requires-Dist: typer<0.16,>=0.9
+Requires-Dist: rpds-py==0.25.1
+Requires-Dist: typer<1,>=0.9.0
 Provides-Extra: ag2-extras
-Requires-Dist: ag2[anthropic]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[bedrock]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[cohere]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[gemini]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[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: ag2[groq]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[interop-crewai]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[interop-langchain]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[lmm]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[mistral]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[neo4j]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[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: ag2[ollama]==0.8.7; extra == 'ag2-extras'
-Requires-Dist: ag2[together]==0.8.7; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[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: ag2[websurfer]==0.8.7; extra == 'ag2-extras'
+Requires-Dist: ag2[anthropic]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[bedrock]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[cohere]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[gemini]==0.9.2; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[gemini]==0.9.2; (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: ag2[groq]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[interop-crewai]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[interop-langchain]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[lmm]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[mistral]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[neo4j]==0.9.2; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[neo4j]==0.9.2; (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: ag2[ollama]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[redis]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[together]==0.9.2; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[together]==0.9.2; (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: ag2[websockets]==0.9.2; extra == 'ag2-extras'
+Requires-Dist: ag2[websurfer]==0.9.2; extra == 'ag2-extras'
 Requires-Dist: beautifulsoup4; 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: crewai-tools<=0.46.0; (python_version < '3.13') and extra == 'ag2-extras'
+Requires-Dist: crewai<1,>=0.76; extra == 'ag2-extras'
+Requires-Dist: embedchain; (python_version < '3.13.3' and sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: embedchain; (python_version < '3.13.3' and 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: hf-xet<2.0.0,>=1.1.2; (platform_machine == 'x86_64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'ARM64' or platform_machine == 'aarch64') and 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: litellm; extra == 'ag2-extras'
 Requires-Dist: markdownify; extra == 'ag2-extras'
 Requires-Dist: mcp<1.6,>=1.4.0; extra == 'ag2-extras'
+Requires-Dist: mistralai>=1.8.1; extra == 'ag2-extras'
+Requires-Dist: networkx; (python_version < '3.11') and extra == 'ag2-extras'
+Requires-Dist: networkx>=3.5; (python_version >= '3.11') and extra == 'ag2-extras'
+Requires-Dist: opentelemetry-api>=1.34.0; extra == 'ag2-extras'
+Requires-Dist: opentelemetry-sdk>=1.34.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'
-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 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; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: protobuf>=5.29.3; extra == 'ag2-extras'
+Requires-Dist: psycopg>=3.2.6; (sys_platform == 'linux') 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 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[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: 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]; (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: weaviate-client<5,>=4; extra == 'ag2-extras'
 Requires-Dist: wikipedia-api<1.0,>=0.8.1; extra == 'ag2-extras'
 Provides-Extra: dev
+Requires-Dist: ag2[redis]==0.9.2; extra == 'dev'
+Requires-Dist: ag2[websockets]==0.9.2; 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: build==1.2.2.post1; extra == 'dev'
+Requires-Dist: fakeredis>=2.28.1; extra == 'dev'
+Requires-Dist: fastjsonschema>=2.21; extra == 'dev'
 Requires-Dist: flake8==7.2.0; 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: jsonschema==4.24.0; extra == 'dev'
+Requires-Dist: jupyter-server==2.16.0; extra == 'dev'
+Requires-Dist: jupyterlab<5.0,>=4.4.0; extra == 'dev'
+Requires-Dist: mypy-extensions>=1.1.0; extra == 'dev'
+Requires-Dist: mypy==1.16.0; extra == 'dev'
+Requires-Dist: nbclient>=0.10.2; extra == 'dev'
+Requires-Dist: nbconvert>=7.16.6; extra == 'dev'
+Requires-Dist: nbformat>=5.10.4; extra == 'dev'
+Requires-Dist: nodeenv>=1.9.1; extra == 'dev'
+Requires-Dist: notebook-shim>=0.2.4; extra == 'dev'
+Requires-Dist: paho-mqtt<3.0,>=2.1.0; extra == 'dev'
+Requires-Dist: pandas-stubs==2.2.3.250527; 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: pylint==3.3.7; extra == 'dev'
 Requires-Dist: python-dotenv==1.1.0; extra == 'dev'
-Requires-Dist: ruff==0.11.8; extra == 'dev'
+Requires-Dist: ruff==0.11.13; 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-jsonschema==4.24.0.20250528; extra == 'dev'
+Requires-Dist: types-pyyaml==6.0.12.20250516; extra == 'dev'
+Requires-Dist: types-redis==4.6.0.20241004; extra == 'dev'
+Requires-Dist: types-requests==2.32.0.20250602; extra == 'dev'
 Requires-Dist: types-toml==0.10.8.20240310; extra == 'dev'
+Requires-Dist: watchdog==6.0.0; extra == 'dev'
 Requires-Dist: yamllint==1.37.1; extra == 'dev'
 Provides-Extra: docs
+Requires-Dist: markdown-callouts==0.4.0; 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-autorefs==1.4.2; extra == 'docs'
+Requires-Dist: mkdocs-awesome-nav==3.1.2; 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.12; extra == 'docs'
+Requires-Dist: mkdocs-material==9.6.14; 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==0.3.7; extra == 'docs'
+Requires-Dist: mkdocstrings-python==1.16.12; extra == 'docs'
 Requires-Dist: mkdocstrings[crystal,python]==0.29.1; extra == 'docs'
+Requires-Dist: natsort==8.4.0; 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.7; extra == 'jupyter'
+Requires-Dist: jupyter-server==2.16.0; extra == 'jupyter'
+Requires-Dist: jupyterlab<5.0,>=4.3.0; extra == 'jupyter'
+Requires-Dist: waldiez-jupyter==0.4.9; extra == 'jupyter'
+Provides-Extra: mqtt
+Requires-Dist: paho-mqtt<3.0,>=2.1.0; extra == 'mqtt'
+Provides-Extra: redis
+Requires-Dist: ag2[redis]==0.9.2; extra == 'redis'
 Provides-Extra: runner
-Requires-Dist: waldiez-runner==0.4.7; (python_version >= '3.11') and extra == 'runner'
+Requires-Dist: waldiez-runner==0.4.9; (python_version >= '3.11') and extra == 'runner'
 Provides-Extra: studio
-Requires-Dist: waldiez-studio==0.4.7; extra == 'studio'
+Requires-Dist: waldiez-studio==0.4.9; extra == 'studio'
 Provides-Extra: test
-Requires-Dist: pytest-asyncio==0.26.0; extra == 'test'
+Requires-Dist: ag2[redis]==0.9.2; extra == 'test'
+Requires-Dist: ag2[websockets]==0.9.2; extra == 'test'
+Requires-Dist: fakeredis>=2.28.1; extra == 'test'
+Requires-Dist: paho-mqtt<3.0,>=2.1.0; extra == 'test'
+Requires-Dist: pytest-asyncio==1.0.0; extra == 'test'
 Requires-Dist: pytest-cov==6.1.1; extra == 'test'
 Requires-Dist: pytest-html==4.1.1; extra == 'test'
 Requires-Dist: pytest-sugar==1.0.0; extra == 'test'
 Requires-Dist: pytest-timeout==2.4.0; extra == 'test'
-Requires-Dist: pytest-xdist==3.6.1; extra == 'test'
-Requires-Dist: pytest==8.3.5; extra == 'test'
+Requires-Dist: pytest-xdist==3.7.0; extra == 'test'
+Requires-Dist: pytest==8.4.0; extra == 'test'
+Provides-Extra: websockets
+Requires-Dist: ag2[websockets]==0.9.2; extra == 'websockets'
 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 Downloads](https://static.pepy.tech/badge/waldiez)](https://pepy.tech/projects/waldiez) [![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)
+[![Coverage Status](https://coveralls.io/repos/github/waldiez/waldiez/badge.svg)](https://coveralls.io/github/waldiez/waldiez) [![PyPI Downloads](https://static.pepy.tech/badge/waldiez)](https://pepy.tech/projects/waldiez) [![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)
 
 ## Make AG2 Agents Collaborate: Drag, Drop, and Orchestrate with Waldiez
 
-Design AI Agents and translate a Waldiez flow to AG2:
+Design AI Agents and translate a Waldiez flow to [AG2](https://github.com/ag2ai/ag2/):
 
-
-https://github.com/user-attachments/assets/71d4b8d1-a24b-45ab-ab53-dfc193e8fcaa
-
-To a python script or a jupyter notebook with the corresponding [ag2](https://github.com/ag2ai/ag2/) agents and chats.
+<video src="https://github.com/user-attachments/assets/71d4b8d1-a24b-45ab-ab53-dfc193e8fcaa" controls="controls" autoplay="autoplay" loop="loop" muted="muted" playsinline="playsinline" width="100%" height="100%"></video>
 
 ## Features
 
@@ -175,7 +220,81 @@ If you’re looking for the React component, please refer to [README.npm](https:
 
 > 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:
+To include waldiez on your website using CDN, here is a simple example:
+
+```html
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <script type="importmap">
+          {
+            "imports": {
+              "react": "https://esm.sh/react@19.1.0",
+              "react-dom/client": "https://esm.sh/react-dom@19.1.0/client",
+              "@waldiez/react": "https://esm.sh/@waldiez/react"
+            }
+          }
+        </script>
+        <style>
+            body {
+                margin: 0;
+                padding: 0;
+                justify-content: center;
+                background-color: white;
+                color: black;
+            }
+            @media (prefers-color-scheme: dark) {
+                body {
+                    background-color: black;
+                    color: white;
+                }
+            }
+            #loading {
+                width: 100vw;
+                height: 100vh;
+                padding: 0;
+                margin: 0;
+                display: flex;
+                align-items: center;
+            }
+            #root {
+                display: flex;
+                flex-direction: column;
+                width: 100vw;
+                height: 100vh;
+            }
+            #waldiez-root {
+                position: relative;
+                width: 80vw;
+                height: 80vh;
+                margin: auto;
+            }
+        </style>
+        <link rel="stylesheet" href="https://esm.sh/@waldiez/react/dist/@waldiez.css">
+    </head>
+    <body>
+        <div id="root"></div>
+        <div id="loading">
+            Loading...
+        </div>
+        <script type="module" src="https://esm.sh/tsx"></script>
+        <script type="text/babel">
+          import { createRoot } from "react-dom/client"
+           import { Waldiez } from "@waldiez/react";
+           const root = document.getElementById("root");
+           document.getElementById("loading").style.display = "none";
+           createRoot(root).render(
+                <div id="waldiez-root">
+                    <Waldiez />
+                </div>
+            )
+        </script>
+    </body>
+</html>
+```
+
+To add the waldiez library to your app:
 
 ```shell
 npm install @waldiez/react
@@ -192,7 +311,7 @@ bun add @waldiez/react
 ### UI Options
 
 - For creating-only (no exporting or running) waldiez flows, you can use the playground at <https://waldiez.github.io>.
-- There is also a jupyterlab extension [here](https://github.com/waldiez/jupyter)
+- There is also a jupyterlab extension here: [waldiez/jupyter](https://github.com/waldiez/jupyter)
 - You also can use the vscode extension:
   - [repo](https://github.com/waldiez/vscode)
   - [marketplace](https://marketplace.visualstudio.com/items?itemName=Waldiez.waldiez-vscode)
@@ -213,39 +332,65 @@ pip install waldiez[studio,jupyter]
 # Convert a Waldiez flow to a python script or a jupyter notebook
 waldiez convert --file /path/to/a/flow.waldiez --output /path/to/an/output/flow[.py|.ipynb]
 # Convert and run the script, optionally force generation if the output file already exists
-waldiez run --file /path/to/a/flow.waldiez --output /path/to/an/output/flow[.py] [--force]
+waldiez run --file /path/to/a/flow.waldiez --output /path/to/an/output/flow[.py|.ipynb] [--force]
 ```
 
 ### Using docker/podman
 
-```shell
-CONTAINER_COMMAND=docker # or podman
-# pull the image
-$CONTAINER_COMMAND pull waldiez/waldiez
-# Convert a Waldiez flow to a python script or a jupyter notebook
-$CONTAINER_COMMAND run \
-  --rm \
-  -v /path/to/a/flow.waldiez:/flow.waldiez \
-  -v /path/to/an/output:/output \
-  waldiez/waldiez convert --file /flow.waldiez --output /output/flow[.py|.ipynb] [--force]
-
-# with selinux and/or podman, you might get permission (or file not found) errors, so you can try:
-$CONTAINER_COMMAND run \
-  --rm \
-  -v /path/to/a/flow.waldiez:/flow.waldiez \
-  -v /path/to/an/output:/output \
-  --userns=keep-id \
-  --security-opt label=disable \
-  waldiez/waldiez convert --file /flow.waldiez --output /output/flow[.py|.ipynb] [--force]
+### 🪟 Windows (PowerShell with Docker or Podman Desktop)
+
+```powershell
+$hostInputFile = "C:\Users\YourName\Documents\flow.waldiez"
+$containerInputFile = "/home/waldiez/workspace/flow.waldiez"
+$hostOutputDir = "C:\Users\YourName\Documents\waldiez_output"
+$containerOutputDir = "/home/waldiez/output"
+$containerOutputFile = "/home/waldiez/output/flow.ipynb"
+
+# Convert a flow to Jupyter Notebook
+docker run --rm `
+  -v "$hostInputFile:$containerInputFile" `
+  -v "$hostOutputDir:$containerOutputDir" `
+  waldiez/waldiez convert --file $hostInputFile --output $containerOutputFile
+
+# Convert and run it
+docker run --rm `
+  -v "$flow:/home/waldiez/workspace/flow.waldiez" `
+  -v "$output:/output" `
+  waldiez/waldiez run --file $hostInputFile --output $containerOutputFile
 ```
 
+> Note
+  If using Hyper-V mode, make sure your files are in a shared folder Docker Desktop has access to.  
+  More info: <https://docs.docker.com/desktop/settings/windows/#file-sharing>
+
+### 🐧 Linux/macOS/WSL (Docker or Podman)
+
 ```shell
-# Convert and run the script
-$CONTAINER_COMMAND run \
-  --rm \
-  -v /path/to/a/flow.waldiez:/flow.waldiez \
-  -v /path/to/an/output:/output \
-  waldiez/waldiez run --file /flow.waldiez --output /output/output[.py]
+CONTAINER_COMMAND=docker # or podman
+# Asuming ./flow.waldiez exists
+HOST_INPUT="$(pwd)/flow.waldiez"
+CONTAINER_INPUT="/home/waldiez/workspace/flow.waldiez"
+HOST_OUTPUT_DIR="$(pwd)/output"
+CONTAINER_OUTPUT_DIR="/home/waldiez/output"
+mkdir -p ${HOST_OUTPUT_DIR}
+
+# Convert a flow to a Python script
+$CONTAINER_COMMAND run --rm \
+  -v ${HOST_INPUT}:${CONTAINER_INPUT} \
+  -v ${HOST_OUTPUT_DIR}:${CONTAINER_OUTPUT_DIR} \
+  waldiez/waldiez convert --file $HOST_INPUT --output ${CONTAINER_OUTPUT_DIR}/flow.py
+
+# Convert to a Jupyter Notebook instead
+$CONTAINER_COMMAND run --rm \
+  -v ${HOST_INPUT}:${CONTAINER_INPUT} \
+  -v ${HOST_OUTPUT_DIR}:${CONTAINER_OUTPUT_DIR} \
+  waldiez/waldiez convert --file $HOST_INPUT --output ${CONTAINER_OUTPUT_DIR}/flow.ipynb
+
+# Convert and run it (force override generated file if it exists)
+$CONTAINER_COMMAND run --rm -it \
+  -v ${HOST_INPUT}:${CONTAINER_INPUT} \
+  -v ${HOST_OUTPUT_DIR}:${CONTAINER_OUTPUT_DIR} \
+  waldiez/waldiez run --file $HOST_INPUT --force
 ```
 
 ### As a library
@@ -313,9 +458,10 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
   <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://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/waldiez/commits?author=lazToum" title="Code">💻</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>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/amaliacontiero"><img src="https://avatars.githubusercontent.com/u/29499343?v=4?s=100" width="100px;" alt="Amalia Contiero"/><br /><sub><b>Amalia Contiero</b></sub></a><br /><a href="https://github.com/waldiez/vscode/commits?author=amaliacontiero" title="Code">💻</a> <a href="https://github.com/waldiez/vscode/issues?q=author%3Aamaliacontiero" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hchris0"><img src="https://avatars.githubusercontent.com/u/23460824?v=4?s=100" width="100px;" alt="Christos Chatzigeorgiou"/><br /><sub><b>Christos Chatzigeorgiou</b></sub></a><br /><a href="https://github.com/waldiez/runner/commits?author=hchris0" title="Code">💻</a></td>
     </tr>
   </tbody>
   <tfoot>
@@ -334,8 +480,6 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
 
 <!-- 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/waldiez/blob/main/LICENSE).