pygpt-net 2.6.58__py3-none-any.whl → 2.6.60__py3-none-any.whl

pygpt_net/ui/widget/node_editor/utils.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ================================================== #
+# This file is a part of PYGPT package               #
+# Website: https://pygpt.net                         #
+# GitHub:  https://github.com/szczyglis-dev/py-gpt   #
+# MIT License                                        #
+# Created By  : Marcin Szczygliński                  #
+# Updated Date: 2025.09.24 00:00:00                  #
+# ================================================== #
+
+# Safety: check C++ pointer validity to avoid calling methods on deleted Qt objects
+try:
+    from shiboken6 import isValid as _qt_is_valid
+except Exception:
+    def _qt_is_valid(obj) -> bool:
+        return obj is not None

pygpt_net/ui/widget/node_editor/view.py

@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ================================================== #
+# This file is a part of PYGPT package               #
+# Website: https://pygpt.net                         #
+# GitHub:  https://github.com/szczyglis-dev/py-gpt   #
+# MIT License                                        #
+# Created By  : Marcin Szczygliński                  #
+# Updated Date: 2025.09.24 00:00:00                  #
+# ================================================== #
+
+from __future__ import annotations
+from typing import Optional, Tuple
+
+from PySide6.QtCore import Qt, QPointF, QRectF, QObject, Signal
+from PySide6.QtGui import QColor, QPainter, QPen, QTransform
+from PySide6.QtWidgets import QWidget, QGraphicsView, QGraphicsScene
+
+
+# ------------------------ Graphics View / Scene ------------------------
+
+class NodeGraphicsView(QGraphicsView):
+    """Zoomable, pannable view with a grid background.
+
+    The view renders a lightweight grid and supports:
+    - Ctrl + Mouse Wheel zooming
+    - Middle Mouse Button panning
+    - Rubber band selection
+
+    Notes:
+        - Space-panning is intentionally disabled to not conflict with typing in editors.
+        - All keyboard shortcuts (e.g., Delete) are handled at the NodeEditor level.
+
+    Args:
+        scene: Shared QGraphicsScene instance for the editor.
+        parent: Optional parent widget.
+    """
+    def __init__(self, scene: QGraphicsScene, parent: Optional[QWidget] = None):
+        super().__init__(scene, parent)
+        self.setRenderHints(self.renderHints() |
+                            QPainter.Antialiasing | QPainter.TextAntialiasing | QPainter.SmoothPixmapTransform)
+        self.setViewportUpdateMode(QGraphicsView.FullViewportUpdate)
+        self.setDragMode(QGraphicsView.RubberBandDrag)
+        self.setTransformationAnchor(QGraphicsView.AnchorUnderMouse)
+        a = QGraphicsView.AnchorViewCenter
+        self.setResizeAnchor(a)
+        self.setFocusPolicy(Qt.StrongFocus)
+
+        self._zoom = 1.0
+        self._zoom_step = 1.15
+        self._min_zoom = 0.2
+        self._max_zoom = 3.0
+
+        self._panning = False
+        self._last_pan_pos = None
+
+    def drawBackground(self, painter: QPainter, rect: QRectF):
+        """Draw the checker grid in the background.
+
+        The grid spacing is fixed (20 px). Colors are read from the owning NodeEditor
+        instance if available, which allows dynamic theming.
+
+        Args:
+            painter: Active QPainter provided by Qt.
+            rect: The exposed background rect to be filled.
+        """
+        parent_editor = self.parent()  # NodeEditor
+        color_back = getattr(parent_editor, "_grid_back_color", QColor(35, 35, 38))
+        color_pen = getattr(parent_editor, "_grid_pen_color", QColor(55, 55, 60))
+        painter.fillRect(rect, color_back)
+        pen = QPen(color_pen)
+        pen.setWidthF(1.0)
+        painter.setPen(pen)
+        grid = 20
+        left = int(rect.left()) - (int(rect.left()) % grid)
+        top = int(rect.top()) - (int(rect.top()) % grid)
+        x = left
+        while x < rect.right():
+            painter.drawLine(x, rect.top(), x, rect.bottom())
+            x += grid
+        y = top
+        while y < rect.bottom():
+            painter.drawLine(rect.left(), y, rect.right(), y)
+            y += grid
+
+    def keyPressEvent(self, e):
+        """Pass-through: the view does not handle special keys.
+
+        ESC and other keys are intentionally left for the host application/editor.
+        """
+        super().keyPressEvent(e)
+
+    def keyReleaseEvent(self, e):
+        """Pass-through for key release."""
+        super().keyReleaseEvent(e)
+
+    def wheelEvent(self, e):
+        """Handle Ctrl + Wheel zoom. Otherwise, default wheel behavior (scroll)."""
+        if e.modifiers() & Qt.ControlModifier:
+            self._apply_zoom(self._zoom_step if e.angleDelta().y() > 0 else 1.0 / self._zoom_step)
+            e.accept()
+            return
+        super().wheelEvent(e)
+
+    def mousePressEvent(self, e):
+        """Start panning with Middle Mouse Button; otherwise defer to base implementation."""
+        if e.button() == Qt.MiddleButton:
+            self._panning = True
+            self._last_pan_pos = e.position()
+            self.setCursor(Qt.ClosedHandCursor)
+            e.accept()
+            return
+        super().mousePressEvent(e)
+
+    def mouseMoveEvent(self, e):
+        """While panning, translate scrollbars. Otherwise defer."""
+        if self._panning and self._last_pan_pos is not None:
+            delta = e.position() - self._last_pan_pos
+            self._last_pan_pos = e.position()
+            self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - int(delta.x()))
+            self.verticalScrollBar().setValue(self.verticalScrollBar().value() - int(delta.y()))
+            e.accept()
+            return
+        super().mouseMoveEvent(e)
+
+    def mouseReleaseEvent(self, e):
+        """Stop panning on Middle Mouse Button release; otherwise defer."""
+        if self._panning and e.button() == Qt.MiddleButton:
+            self._panning = False
+            self.setCursor(Qt.ArrowCursor)
+            e.accept()
+            return
+        super().mouseReleaseEvent(e)
+
+    def zoom_in(self):
+        """Programmatically zoom in by a predefined step."""
+        self._apply_zoom(self._zoom_step)
+
+    def zoom_out(self):
+        """Programmatically zoom out by a predefined step."""
+        self._apply_zoom(1.0 / self._zoom_step)
+
+    def _apply_zoom(self, factor: float):
+        """Apply zoom scaling factor within configured bounds.
+
+        Args:
+            factor: Multiplicative factor to apply to the current zoom.
+
+        Notes:
+            The method clamps the result to [_min_zoom, _max_zoom] to prevent
+            excessive zooming.
+        """
+        new_zoom = self._zoom * factor
+        if not (self._min_zoom <= new_zoom <= self._max_zoom):
+            return
+        self._zoom = new_zoom
+        self.scale(factor, factor)
+
+    def zoom_value(self) -> float:
+        """Return the current zoom factor."""
+        return float(self._zoom)
+
+    def set_zoom_value(self, zoom: float, keep_center: bool = False):
+        """Set an absolute zoom factor and optionally keep the current viewport center."""
+        if zoom is None:
+            return
+        z = max(self._min_zoom, min(self._max_zoom, float(zoom)))
+        center_scene = None
+        if keep_center and self.viewport() is not None and self.viewport().rect().isValid():
+            center_scene = self.mapToScene(self.viewport().rect().center())
+
+        # Reset and apply new transform to avoid cumulative floating errors
+        self.resetTransform()
+        self._zoom = 1.0
+        if abs(z - 1.0) > 1e-9:
+            self.scale(z, z)
+            self._zoom = z
+
+        if keep_center and center_scene is not None:
+            self.centerOn(center_scene)
+
+    def get_scroll_values(self) -> Tuple[int, int]:
+        """Return (horizontal, vertical) scrollbar values."""
+        h = self.horizontalScrollBar().value() if self.horizontalScrollBar() else 0
+        v = self.verticalScrollBar().value() if self.verticalScrollBar() else 0
+        return int(h), int(v)
+
+    def set_scroll_values(self, h: int, v: int):
+        """Set horizontal and vertical scrollbar values."""
+        if self.horizontalScrollBar():
+            self.horizontalScrollBar().setValue(int(h))
+        if self.verticalScrollBar():
+            self.verticalScrollBar().setValue(int(v))
+
+    def view_state(self) -> dict:
+        """Return a serializable view state: zoom and scrollbars."""
+        h, v = self.get_scroll_values()
+        return {"zoom": float(self._zoom), "h": h, "v": v}
+
+    def set_view_state(self, state: dict):
+        """Apply a view state previously produced by view_state()."""
+        if not isinstance(state, dict):
+            return
+        z = state.get("zoom") or state.get("scale")
+        if z is not None:
+            try:
+                self.set_zoom_value(float(z), keep_center=False)
+            except Exception:
+                pass
+        h = state.get("h") or state.get("hScroll") or state.get("x")
+        v = state.get("v") or state.get("vScroll") or state.get("y")
+        try:
+            if h is not None:
+                self.set_scroll_values(int(h), int(v if v is not None else 0))
+            elif v is not None:
+                # set vertical if only v present
+                self.set_scroll_values(self.get_scroll_values()[0], int(v))
+        except Exception:
+            pass
+
+
+class NodeGraphicsScene(QGraphicsScene):
+    """Graphics scene extended with custom context menu emission."""
+    sceneContextRequested = Signal(QPointF)
+
+    def __init__(self, parent: Optional[QObject] = None):
+        """Initialize the scene and set a very large scene rect.
+
+        Using a large default rect avoids sudden scene rect changes while panning/zooming.
+        """
+        super().__init__(parent)
+        self.setSceneRect(-5000, -5000, 10000, 10000)
+
+    def contextMenuEvent(self, event):
+        """Emit a scene-level context menu request when clicking empty space.
+
+        If the click is not on any item, the signal sceneContextRequested is emitted with
+        the scene position. Otherwise, default handling is used (propagating to items).
+        """
+        transform = self.views()[0].transform() if self.views() else QTransform()
+        item = self.itemAt(event.scenePos(), transform)
+        if item is None:
+            self.sceneContextRequested.emit(event.scenePos())
+            event.accept()
+            return
+        super().contextMenuEvent(event)
+

pygpt_net/ui/widget/textarea/web.py

@@ -531,7 +531,7 @@ class CustomWebEnginePage(QWebEnginePage):
         return super().acceptNavigationRequest(url, _type, isMainFrame)
 
     def javaScriptConsoleMessage(self, level, message, line_number, source_id):
-        print("[JS CONSOLE] Line", line_number, ":", message)
+        #  print("[JS CONSOLE] Line", line_number, ":", message)
         self.signals.js_message.emit(line_number, message, source_id)  # handled in debug controller
 
     def cleanup(self):

{pygpt_net-2.6.58.dist-info → pygpt_net-2.6.60.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pygpt-net
-Version: 2.6.58
+Version: 2.6.60
 Summary: Desktop AI Assistant powered by: OpenAI GPT-5, GPT-4, o1, o3, Gemini, Claude, Grok, DeepSeek, and other models supported by Llama Index, and Ollama. Chatbot, agents, completion, image generation, vision analysis, speech-to-text, plugins, MCP, internet access, file handling, command execution and more.
 License: MIT
 Keywords: ai,api,api key,app,assistant,bielik,chat,chatbot,chatgpt,claude,dall-e,deepseek,desktop,gemini,gpt,gpt-3.5,gpt-4,gpt-4-vision,gpt-4o,gpt-5,gpt-oss,gpt3.5,gpt4,grok,langchain,llama-index,llama3,mistral,o1,o3,ollama,openai,presets,py-gpt,py_gpt,pygpt,pyside,qt,text completion,tts,ui,vision,whisper
@@ -20,91 +20,89 @@ Requires-Dist: Markdown (>=3.8.2,<4.0.0)
 Requires-Dist: PyAudio (>=0.2.14,<0.3.0)
 Requires-Dist: PyAutoGUI (>=0.9.54,<0.10.0)
 Requires-Dist: PySide6 (==6.9.1)
-Requires-Dist: Pygments (>=2.19.2,<3.0.0)
-Requires-Dist: SQLAlchemy (>=2.0.43,<3.0.0)
+Requires-Dist: Pygments (==2.19.2)
+Requires-Dist: SQLAlchemy (==2.0.43)
 Requires-Dist: SpeechRecognition (>=3.14.3,<4.0.0)
 Requires-Dist: Telethon (>=1.40.0,<2.0.0)
-Requires-Dist: anthropic (>=0.54.0,<0.55.0)
-Requires-Dist: azure-core (>=1.35.0,<2.0.0)
-Requires-Dist: beautifulsoup4 (>=4.13.5,<5.0.0)
-Requires-Dist: boto3 (>=1.40.17,<2.0.0)
-Requires-Dist: chromadb (>=0.5.20,<0.6.0)
+Requires-Dist: anthropic (>=0.68.0,<0.69.0)
+Requires-Dist: azure-core (==1.35.1)
+Requires-Dist: beautifulsoup4 (==4.13.5)
+Requires-Dist: chromadb (==1.1.0)
 Requires-Dist: croniter (>=2.0.7,<3.0.0)
 Requires-Dist: ddgs (>=9.5.5,<10.0.0)
 Requires-Dist: docker (>=7.1.0,<8.0.0)
 Requires-Dist: docx2txt (>=0.8,<0.9)
-Requires-Dist: gkeepapi (>=0.15.1,<0.16.0)
-Requires-Dist: google-api-python-client (>=2.179.0,<3.0.0)
-Requires-Dist: google-generativeai (>=0.8.5,<0.9.0)
-Requires-Dist: grpcio (>=1.74.0,<2.0.0)
-Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: gkeepapi (==0.15.1)
+Requires-Dist: google-api-python-client (==2.182.0)
+Requires-Dist: google-generativeai (==0.8.5)
+Requires-Dist: grpcio (==1.75.0)
+Requires-Dist: httpx (==0.28.1)
 Requires-Dist: httpx-socks (>=0.10.1,<0.11.0)
-Requires-Dist: huggingface-hub (>=0.33.5,<0.34.0)
+Requires-Dist: huggingface-hub (==0.35.0)
 Requires-Dist: ipykernel (>=6.30.1,<7.0.0)
 Requires-Dist: jupyter_client (>=8.6.3,<9.0.0)
-Requires-Dist: llama-index (>=0.12.44,<0.13.0)
-Requires-Dist: llama-index-agent-openai (>=0.4.12,<0.5.0)
-Requires-Dist: llama-index-core (==0.12.44)
-Requires-Dist: llama-index-embeddings-azure-openai (>=0.3.9,<0.4.0)
-Requires-Dist: llama-index-embeddings-gemini (>=0.3.2,<0.4.0)
-Requires-Dist: llama-index-embeddings-google-genai (>=0.2.1,<0.3.0)
-Requires-Dist: llama-index-embeddings-huggingface-api (>=0.3.1,<0.4.0)
-Requires-Dist: llama-index-embeddings-mistralai (>=0.3.0,<0.4.0)
-Requires-Dist: llama-index-embeddings-ollama (>=0.5.0,<0.6.0)
-Requires-Dist: llama-index-embeddings-openai (>=0.3.1,<0.4.0)
-Requires-Dist: llama-index-embeddings-openai-like (>=0.1.1,<0.2.0)
-Requires-Dist: llama-index-embeddings-voyageai (>=0.3.6,<0.4.0)
-Requires-Dist: llama-index-llms-anthropic (>=0.6.19,<0.7.0)
-Requires-Dist: llama-index-llms-azure-openai (>=0.3.4,<0.4.0)
-Requires-Dist: llama-index-llms-deepseek (>=0.1.2,<0.2.0)
-Requires-Dist: llama-index-llms-gemini (>=0.5.0,<0.6.0)
-Requires-Dist: llama-index-llms-google-genai (>=0.2.6,<0.3.0)
-Requires-Dist: llama-index-llms-huggingface-api (>=0.3.1,<0.4.0)
-Requires-Dist: llama-index-llms-mistralai (>=0.6.1,<0.7.0)
-Requires-Dist: llama-index-llms-ollama (>=0.6.2,<0.7.0)
-Requires-Dist: llama-index-llms-openai (>=0.4.7,<0.5.0)
-Requires-Dist: llama-index-llms-openai-like (>=0.4.0,<0.5.0)
-Requires-Dist: llama-index-llms-perplexity (>=0.3.7,<0.4.0)
-Requires-Dist: llama-index-multi-modal-llms-openai (>=0.5.1,<0.6.0)
-Requires-Dist: llama-index-readers-chatgpt-plugin (>=0.3.0,<0.4.0)
-Requires-Dist: llama-index-readers-database (>=0.3.0,<0.4.0)
-Requires-Dist: llama-index-readers-file (>=0.4.11,<0.5.0)
-Requires-Dist: llama-index-readers-github (>=0.5.0,<0.6.0)
-Requires-Dist: llama-index-readers-google (>=0.5.0,<0.6.0)
-Requires-Dist: llama-index-readers-microsoft-onedrive (>=0.3.0,<0.4.0)
-Requires-Dist: llama-index-readers-twitter (>=0.3.0,<0.4.0)
-Requires-Dist: llama-index-readers-web (>=0.3.9,<0.4.0)
-Requires-Dist: llama-index-vector-stores-chroma (>=0.4.2,<0.5.0)
-Requires-Dist: llama-index-vector-stores-elasticsearch (==0.4.0)
-Requires-Dist: llama-index-vector-stores-pinecone (>=0.6.0,<0.7.0)
-Requires-Dist: llama-index-vector-stores-redis (>=0.4.0,<0.5.0)
+Requires-Dist: llama-index (==0.13.6)
+Requires-Dist: llama-index-core (==0.13.6)
+Requires-Dist: llama-index-embeddings-azure-openai (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-embeddings-gemini (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-embeddings-google-genai (>=0.3.1,<0.4.0)
+Requires-Dist: llama-index-embeddings-huggingface-api (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-embeddings-mistralai (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-embeddings-ollama (>=0.8.3,<0.9.0)
+Requires-Dist: llama-index-embeddings-openai (>=0.5.1,<0.6.0)
+Requires-Dist: llama-index-embeddings-openai-like (>=0.2.2,<0.3.0)
+Requires-Dist: llama-index-embeddings-voyageai (>=0.4.2,<0.5.0)
+Requires-Dist: llama-index-llms-anthropic (>=0.8.6,<0.9.0)
+Requires-Dist: llama-index-llms-azure-openai (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-llms-deepseek (>=0.2.2,<0.3.0)
+Requires-Dist: llama-index-llms-gemini (>=0.6.1,<0.7.0)
+Requires-Dist: llama-index-llms-google-genai (>=0.3.1,<0.4.0)
+Requires-Dist: llama-index-llms-huggingface-api (>=0.6.1,<0.7.0)
+Requires-Dist: llama-index-llms-mistralai (>=0.7.1,<0.8.0)
+Requires-Dist: llama-index-llms-ollama (>=0.7.3,<0.8.0)
+Requires-Dist: llama-index-llms-openai (>=0.5.6,<0.6.0)
+Requires-Dist: llama-index-llms-openai-like (>=0.5.1,<0.6.0)
+Requires-Dist: llama-index-llms-perplexity (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-multi-modal-llms-openai (>=0.6.1,<0.7.0)
+Requires-Dist: llama-index-readers-chatgpt-plugin (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-readers-database (>=0.5.1,<0.6.0)
+Requires-Dist: llama-index-readers-file (>=0.5.4,<0.6.0)
+Requires-Dist: llama-index-readers-github (>=0.8.2,<0.9.0)
+Requires-Dist: llama-index-readers-google (>=0.7.2,<0.8.0)
+Requires-Dist: llama-index-readers-microsoft-onedrive (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-readers-twitter (>=0.4.1,<0.5.0)
+Requires-Dist: llama-index-readers-web (>=0.5.3,<0.6.0)
+Requires-Dist: llama-index-vector-stores-chroma (>=0.5.3,<0.6.0)
+Requires-Dist: llama-index-vector-stores-elasticsearch (==0.5.1)
+Requires-Dist: llama-index-vector-stores-pinecone (>=0.7.1,<0.8.0)
+Requires-Dist: llama-index-vector-stores-redis (>=0.6.1,<0.7.0)
 Requires-Dist: mcp (>=1.13.1,<2.0.0)
 Requires-Dist: mss (>=9.0.2,<10.0.0)
 Requires-Dist: nbconvert (>=7.16.6,<8.0.0)
-Requires-Dist: numpy (>=1.26.4,<2.0.0)
-Requires-Dist: onnxruntime (==1.20.1)
-Requires-Dist: openai (==1.96.1)
+Requires-Dist: numpy (==1.26.4)
+Requires-Dist: onnxruntime (==1.22.1)
+Requires-Dist: openai (==1.108.2)
 Requires-Dist: openai-agents (>=0.2.3,<0.3.0)
 Requires-Dist: opencv-python (>=4.11.0.86,<5.0.0.0)
 Requires-Dist: packaging (>=25.0,<26.0)
-Requires-Dist: pandas (>=2.2.3,<3.0.0)
+Requires-Dist: pandas (==2.2.3)
 Requires-Dist: paramiko (>=4.0.0,<5.0.0)
-Requires-Dist: pillow (>=10.4.0,<11.0.0)
+Requires-Dist: pillow (==10.4.0)
 Requires-Dist: pinecone (>=7.0.1,<8.0.0)
 Requires-Dist: psutil (>=7.0.0,<8.0.0)
 Requires-Dist: pydub (>=0.25.1,<0.26.0)
 Requires-Dist: pygame (>=2.6.1,<3.0.0)
 Requires-Dist: pynput (>=1.8.1,<2.0.0)
-Requires-Dist: pypdf (>=5.9.0,<6.0.0)
+Requires-Dist: pypdf (==6.1.0)
 Requires-Dist: pyserial (>=3.5,<4.0)
 Requires-Dist: python-markdown-math (>=0.8,<0.9)
 Requires-Dist: qasync (>=0.27.1,<0.28.0)
 Requires-Dist: qt-material (>=2.17,<3.0)
-Requires-Dist: redis (>=5.3.1,<6.0.0)
+Requires-Dist: redis (==5.3.1)
 Requires-Dist: show-in-file-manager (>=1.1.5,<2.0.0)
-Requires-Dist: tiktoken (>=0.9.0,<0.10.0)
-Requires-Dist: transformers (==4.48.3)
-Requires-Dist: urllib3 (>=1.26.20,<2.0.0)
+Requires-Dist: tiktoken (==0.11.0)
+Requires-Dist: transformers (==4.56.2)
+Requires-Dist: urllib3 (==2.5.0)
 Requires-Dist: wikipedia (>=1.4.0,<2.0.0)
 Requires-Dist: xai-sdk (>=1.1.0,<2.0.0)
 Requires-Dist: youtube-transcript-api (>=0.6.3,<0.7.0)
@@ -119,7 +117,7 @@ Description-Content-Type: text/markdown
 
 [![pygpt](https://snapcraft.io/pygpt/badge.svg)](https://snapcraft.io/pygpt)
 
-Release: **2.6.58** | build: **2025-09-22** | Python: **>=3.10, <3.14**
+Release: **2.6.60** | build: **2025-09-25** | Python: **>=3.10, <3.14**
 
 > Official website: https://pygpt.net | Documentation: https://pygpt.readthedocs.io
 > 
@@ -182,6 +180,7 @@ You can download compiled 64-bit versions for Windows and Linux here: https://py
 - Provides an intuitive operation and interface.
 - Includes a notepad.
 - Includes simple painter / drawing tool.
+- Includes an node-based Agents Builder.
 - Supports multiple languages.
 - Requires no previous knowledge of using AI models.
 - Simplifies image generation using image models like `DALL-E` and `Imagen`.
@@ -2090,6 +2089,7 @@ PyGPT features several useful tools, including:
 - HTML/JS Canvas (built-in HTML renderer)
 - Translator
 - Web Browser (Chromium)
+- Agents Builder (beta)
 
 ![v2_tool_menu](https://github.com/szczyglis-dev/py-gpt/raw/master/docs/source/images/v2_tool_menu.png)
 
@@ -2167,6 +2167,70 @@ Enables translation between multiple languages using an AI model.
 
 A built-in web browser based on Chromium, allowing you to open webpages directly within the app. **SECURITY NOTICE:** For your protection, avoid using the built-in browser for sensitive or critical tasks. It is intended for basic use only.
 
+# Agents Builder (beta)
+
+To launch the Agent Editor, navigate to:
+
+`Tools -> Agents Builder`
+
+![nodes](https://github.com/szczyglis-dev/py-gpt/raw/master/docs/source/images/nodes.png)
+
+This tool allows you to create workflows for agents using a node editor, without writing any code. You can add a new agent type, and it will appear in the list of presets.
+
+To add a new element, right-click on the editor grid and select `Add` to insert a new node.
+
+**Types of Nodes:**
+
+- **Flow/Start**: The starting point for agents (user input).
+- **Flow/Agent**: A single agent with customizable default parameters, such as system instructions and tool usage. These settings can be overridden in the preset.
+- **Flow/Memory**: Shared memory between agents (shared Context).
+- **Flow/End**: The endpoint, returning control to the user.
+
+Agents with connected shared memory share it among themselves. Agents without shared memory only receive the latest output from the previous agent.
+
+The first agent in the sequence always receives the full context passed by the user.
+
+Connecting agents and memory is done using node connections via slots. To connect slots, simply drag from the input port to the output port (Ctrl + mouse button removes a connection).
+
+**Node Editor Navigation:**
+
+- **Right-click**: Add node, undo, redo, clear
+- **Middle-click + drag**: Pan view
+- **Ctrl + Mouse wheel**: Zoom
+- **Left-click a port**: Create connection
+- **Ctrl + Left-click a port**: Rewire or detach connection
+- **Right-click or DELETE a node/connection**: Remove node/connection
+
+**Tip:** Enable agent debugging in `Settings -> Debug -> Log Agents usage to console` to log the full workflow to the console.
+
+Agents built using this tool are compatible with both OpenAI Agents and LlamaIndex.
+
+**Notes:**
+
+Routing and system instruction: for every agent that has more than one connection leading to the next agent, a routing instruction is automatically injected just before your system prompt:
+
+```
+You are a routing-capable agent in a multi-agent flow.
+Your id is: <current_id>, name: <agent_name>.
+You MUST respond ONLY with a single JSON object and nothing else.
+Schema:
+{
+  "route": "<ID of the next agent from allowed_routes OR the string 'end'>",
+  "content": "<final response text for the user (or tool result)>"
+}
+Rules:
+- allowed_routes: [<allowed>]
+- If you want to finish the flow, set route to "end".
+- content must contain the user-facing answer (you may include structured data as JSON or Markdown inside content).
+- Do NOT add any commentary outside of the JSON. No leading or trailing text.
+- If using tools, still return the final JSON with tool results summarized in content.
+- Human-friendly route names: <friendly>
+
+<here begins your system instruction>
+```
+
+**INFO:** Agents Builder is in beta.
+
 
 # Token usage calculation
 
@@ -3660,6 +3724,16 @@ may consume additional tokens that are not displayed in the main window.
 
 ## Recent changes:
 
+**2.6.60 (2025-09-25)**
+
+- Added a new tool: Agents Builder - allowing visual design of agent workflows using nodes - available in Tools -> Agents Builder (beta).
+
+**2.6.59 (2025-09-23)**
+
+- LlamaIndex has been upgraded to v0.13.6.
+- The Responses API is disabled by default in Agents (LlamaIndex) for compatibility.
+- Added WinAPI support to the System (OS) plugin.
+
 **2.6.58 (2025-09-22)**
 
 - Added: internal Web Browser tool.