lybic-guiagents 0.1.0__tar.gz → 0.2.1__tar.gz

{lybic_guiagents-0.1.0/lybic_guiagents.egg-info → lybic_guiagents-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lybic-guiagents
-Version: 0.1.0
+Version: 0.2.1
 Summary: An open-source agentic framework that enables AI to use computers like humans and can provide a multi-agent runtime environment as an infrastructure capability
 Author: Lybic Development Team
 Author-email: Lybic Development Team <lybic@tingyutech.com>
@@ -9,88 +9,145 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.9, <=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: numpy
+Requires-Dist: dotenv
+Requires-Dist: pyperclip
+Requires-Dist: Pillow>=11.3.0
 Requires-Dist: backoff
-Requires-Dist: pandas
-Requires-Dist: openai
+Requires-Dist: numpy
 Requires-Dist: anthropic
-Requires-Dist: fastapi
+Requires-Dist: openai
+Requires-Dist: google-genai
 Requires-Dist: zhipuai
 Requires-Dist: groq
 Requires-Dist: boto3
-Requires-Dist: uvicorn
-Requires-Dist: paddleocr
-Requires-Dist: paddlepaddle
-Requires-Dist: together
 Requires-Dist: scikit-learn
-Requires-Dist: websockets
 Requires-Dist: tiktoken
-Requires-Dist: pyautogui~=0.9.54
-Requires-Dist: toml
-Requires-Dist: exa_py
-Requires-Dist: black
-Requires-Dist: certifi
-Requires-Dist: pytesseract
-Requires-Dist: google-genai
-Requires-Dist: python-dotenv
-Requires-Dist: Pillow~=11.0.0
-Requires-Dist: fabric
-Requires-Dist: gymnasium~=0.28.1
-Requires-Dist: requests~=2.31.0
-Requires-Dist: pytz~=2024.1
-Requires-Dist: transformers~=4.35.2
-Requires-Dist: torch~=2.5.0
-Requires-Dist: accelerate
-Requires-Dist: opencv-python~=4.8.1.78
-Requires-Dist: matplotlib~=3.7.4
-Requires-Dist: pynput~=1.7.6
-Requires-Dist: psutil~=5.9.6
-Requires-Dist: tqdm~=4.65.0
-Requires-Dist: flask~=3.0.0
-Requires-Dist: requests-toolbelt~=1.0.0
-Requires-Dist: lxml
-Requires-Dist: cssselect
-Requires-Dist: xmltodict
-Requires-Dist: openpyxl
-Requires-Dist: python-docx
-Requires-Dist: python-pptx
-Requires-Dist: pypdf
-Requires-Dist: PyGetWindow
-Requires-Dist: rapidfuzz
-Requires-Dist: pyacoustid
-Requires-Dist: pygame
-Requires-Dist: ImageHash
-Requires-Dist: scikit-image
-Requires-Dist: librosa
-Requires-Dist: pymupdf
-Requires-Dist: chardet
-Requires-Dist: playwright
-Requires-Dist: formulas
-Requires-Dist: pydrive
-Requires-Dist: fastdtw
-Requires-Dist: odfpy
-Requires-Dist: func-timeout
-Requires-Dist: beautifulsoup4
-Requires-Dist: dashscope
-Requires-Dist: google-generativeai
-Requires-Dist: PyYaml
-Requires-Dist: mutagen
-Requires-Dist: easyocr
-Requires-Dist: borb
-Requires-Dist: pypdf2
-Requires-Dist: pdfplumber
-Requires-Dist: wandb
-Requires-Dist: wrapt_timeout_decorator
-Requires-Dist: gdown
-Requires-Dist: azure-identity
-Requires-Dist: azure-mgmt-compute
-Requires-Dist: azure-mgmt-network
-Requires-Dist: docker
-Requires-Dist: loguru
-Requires-Dist: dotenv
+Requires-Dist: pydantic
+Requires-Dist: lybic>=0.7.3
 Requires-Dist: pyobjc; platform_system == "Darwin"
+Requires-Dist: oa_atomacos; platform_system == "Darwin"
 Requires-Dist: pywinauto; platform_system == "Windows"
 Requires-Dist: pywin32; platform_system == "Windows"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Provides-Extra: vmware-and-evaluation
+Requires-Dist: python-pptx; extra == "vmware-and-evaluation"
+Requires-Dist: odfpy; extra == "vmware-and-evaluation"
+Requires-Dist: openpyxl; extra == "vmware-and-evaluation"
+Requires-Dist: pandas; extra == "vmware-and-evaluation"
+Requires-Dist: lxml; extra == "vmware-and-evaluation"
+Requires-Dist: filelock; extra == "vmware-and-evaluation"
+Requires-Dist: xmltodict; extra == "vmware-and-evaluation"
+Requires-Dist: opencv-python-headless; extra == "vmware-and-evaluation"
+Requires-Dist: rapidfuzz; extra == "vmware-and-evaluation"
+Requires-Dist: imagehash; extra == "vmware-and-evaluation"
+Requires-Dist: odfpy; extra == "vmware-and-evaluation"
+Requires-Dist: pdfplumber; extra == "vmware-and-evaluation"
+Requires-Dist: PyYAML; extra == "vmware-and-evaluation"
+Requires-Dist: mutagen; extra == "vmware-and-evaluation"
+Requires-Dist: pypdf; extra == "vmware-and-evaluation"
+Requires-Dist: PyMuPDF; extra == "vmware-and-evaluation"
+Requires-Dist: formulas; extra == "vmware-and-evaluation"
+Requires-Dist: pyacoustid; extra == "vmware-and-evaluation"
+Requires-Dist: opencv-python~=4.8.1.78; extra == "vmware-and-evaluation"
+Requires-Dist: PyPDF2; extra == "vmware-and-evaluation"
+Requires-Dist: librosa; extra == "vmware-and-evaluation"
+Requires-Dist: fastdtw; extra == "vmware-and-evaluation"
+Requires-Dist: scikit-learn; extra == "vmware-and-evaluation"
+Requires-Dist: scikit-image; extra == "vmware-and-evaluation"
+Requires-Dist: bs4; extra == "vmware-and-evaluation"
+Requires-Dist: azure-identity; extra == "vmware-and-evaluation"
+Requires-Dist: azure-mgmt-compute; extra == "vmware-and-evaluation"
+Requires-Dist: azure-mgmt-network; extra == "vmware-and-evaluation"
+Requires-Dist: toml; extra == "vmware-and-evaluation"
+Requires-Dist: easyocr; extra == "vmware-and-evaluation"
+Provides-Extra: pyautogui
+Requires-Dist: pyautogui; extra == "pyautogui"
+Provides-Extra: all
+Requires-Dist: toml; extra == "all"
+Requires-Dist: numpy; extra == "all"
+Requires-Dist: backoff; extra == "all"
+Requires-Dist: pandas; extra == "all"
+Requires-Dist: openai; extra == "all"
+Requires-Dist: anthropic; extra == "all"
+Requires-Dist: zhipuai; extra == "all"
+Requires-Dist: groq; extra == "all"
+Requires-Dist: boto3; extra == "all"
+Requires-Dist: paddlepaddle; extra == "all"
+Requires-Dist: tiktoken; extra == "all"
+Requires-Dist: toml; extra == "all"
+Requires-Dist: exa_py; extra == "all"
+Requires-Dist: google-genai; extra == "all"
+Requires-Dist: python-dotenv; extra == "all"
+Requires-Dist: Pillow>=11.3.0; extra == "all"
+Requires-Dist: gymnasium~=0.28.1; extra == "all"
+Requires-Dist: requests~=2.31.0; extra == "all"
+Requires-Dist: pytz~=2024.1; extra == "all"
+Requires-Dist: psutil~=5.9.6; extra == "all"
+Requires-Dist: tqdm~=4.65.0; extra == "all"
+Requires-Dist: flask~=3.0.0; extra == "all"
+Requires-Dist: requests-toolbelt~=1.0.0; extra == "all"
+Requires-Dist: lxml; extra == "all"
+Requires-Dist: xmltodict; extra == "all"
+Requires-Dist: PyGetWindow; extra == "all"
+Requires-Dist: ImageHash; extra == "all"
+Requires-Dist: scikit-image; extra == "all"
+Requires-Dist: formulas; extra == "all"
+Requires-Dist: pydrive; extra == "all"
+Requires-Dist: fastdtw; extra == "all"
+Requires-Dist: odfpy; extra == "all"
+Requires-Dist: func-timeout; extra == "all"
+Requires-Dist: beautifulsoup4; extra == "all"
+Requires-Dist: dashscope; extra == "all"
+Requires-Dist: google-generativeai; extra == "all"
+Requires-Dist: PyYaml; extra == "all"
+Requires-Dist: mutagen; extra == "all"
+Requires-Dist: easyocr; extra == "all"
+Requires-Dist: borb; extra == "all"
+Requires-Dist: pypdf2; extra == "all"
+Requires-Dist: lybic>=0.7.3; extra == "all"
+Requires-Dist: pdfplumber; extra == "all"
+Requires-Dist: azure-identity; extra == "all"
+Requires-Dist: azure-mgmt-compute; extra == "all"
+Requires-Dist: azure-mgmt-network; extra == "all"
+Requires-Dist: docker; extra == "all"
+Requires-Dist: dotenv; extra == "all"
+Requires-Dist: python-pptx; extra == "all"
+Requires-Dist: odfpy; extra == "all"
+Requires-Dist: openpyxl; extra == "all"
+Requires-Dist: pandas; extra == "all"
+Requires-Dist: lxml; extra == "all"
+Requires-Dist: filelock; extra == "all"
+Requires-Dist: xmltodict; extra == "all"
+Requires-Dist: opencv-python-headless; extra == "all"
+Requires-Dist: Pillow; extra == "all"
+Requires-Dist: imagehash; extra == "all"
+Requires-Dist: rapidfuzz; extra == "all"
+Requires-Dist: fitz; extra == "all"
+Requires-Dist: imagehash; extra == "all"
+Requires-Dist: odfpy; extra == "all"
+Requires-Dist: pdfplumber; extra == "all"
+Requires-Dist: PyYaml; extra == "all"
+Requires-Dist: mutagen; extra == "all"
+Requires-Dist: pypdf; extra == "all"
+Requires-Dist: PyMuPDF; extra == "all"
+Requires-Dist: formulas; extra == "all"
+Requires-Dist: pyacoustid; extra == "all"
+Requires-Dist: opencv-python~=4.8.1.78; extra == "all"
+Requires-Dist: PyPDF2; extra == "all"
+Requires-Dist: librosa; extra == "all"
+Requires-Dist: fastdtw; extra == "all"
+Requires-Dist: scikit-learn; extra == "all"
+Requires-Dist: scikit-image; extra == "all"
+Requires-Dist: bs4; extra == "all"
+Requires-Dist: azure-identity; extra == "all"
+Requires-Dist: azure-mgmt-compute; extra == "all"
+Requires-Dist: azure-mgmt-network; extra == "all"
+Requires-Dist: easyocr; extra == "all"
+Requires-Dist: pyobjc; platform_system == "Darwin" and extra == "all"
+Requires-Dist: oa_atomacos; platform_system == "Darwin" and extra == "all"
+Requires-Dist: pywinauto; platform_system == "Windows" and extra == "all"
+Requires-Dist: pywin32; platform_system == "Windows" and extra == "all"
 Dynamic: author
 Dynamic: license-file
 Dynamic: requires-python
@@ -109,6 +166,19 @@ Dynamic: requires-python
   Lybic GUI Agent: <small>An open-source agentic framework for Computer Use Agents</small> 
 </h1>
 
+<p align="center">
+    <small>Supported OS:</small>
+    <img src="https://img.shields.io/badge/OS-Windows-blue?logo=windows&logoColor=white" alt="Windows">
+    <img src="https://img.shields.io/badge/OS-macOS-black?logo=apple&logoColor=white" alt="macOS">
+    <img src="https://img.shields.io/badge/OS-Linux-yellow?logo=linux&logoColor=black" alt="Linux">
+    <br/>
+    <small>Latest Version:</small><a href="https://pypi.org/project/lybic-guiagents/"><img alt="PyPI" src="https://img.shields.io/pypi/v/lybic-guiagents"></a>
+    &nbsp;
+    <a href="https://github.com/lybic/agent/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/lybic-guiagents"></a>
+    &nbsp;
+    <a href="https://github.com/lybic/agent"><img alt="Stars" src="https://img.shields.io/github/stars/lybic/agent?style=social"></a>
+</p>
+
 ## What is Lybic GUI Agent?
 
 Lybic platform placeholder - comprehensive AI platform for building and deploying intelligent agents
@@ -124,6 +194,7 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 </div>
 
 ## 🥳 Updates
+- [x] **2025/09/14**: The paper has been accepted by [arxiv](https://arxiv.org/abs/2509.11067)
 - [x] **2025/09/09**: We achieved the world's first place in the 50-step length of [OS-world](https://os-world.github.io/)!
 - [x] **2025/08/08**: Released v0.1.0 of [Lybic GUI Agent](https://github.com/lybic/agent) library, with support for Windows, Mac, Ubuntu and Lybic API!
 
@@ -132,6 +203,8 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 1. [💡 Introduction](#-introduction)
 2. [🛠️ Installation & Setup](#%EF%B8%8F-installation--setup) 
 3. [🚀 Usage](#-usage)
+4. [🔧 Troubleshooting](#-troubleshooting)
+5. [💬 Citations](#-citations)
 
 ## 💡 Introduction
 
@@ -161,7 +234,7 @@ Lybic GUI Agent is an open-source framework that enables developers and business
     <tr>
       <td>OSWorld Verified (50 step)</td>
       <td><b>57.1%</b></td>
-      <td>53.1%</td>
+      <td>54.2%</td>
     </tr>
   </table>
 </div>
@@ -176,7 +249,15 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 > [!WARNING]
 > To leverage the full potential of Lybic GUI Agent, we support multiple model providers including OpenAI, Anthropic, Gemini, and Doubao. For the best visual grounding performance, we recommend using UI-TARS models.
 
-### Installation
+### Installation(from pip)
+
+You can install Lybic GUI Agent by using pip:
+
+```bash
+pip install lybic-guiagents
+```
+
+### Installation(from source code)
 
 You can use [UV](https://docs.astral.sh/uv/getting-started/installation/) (a modern Python package manager) version 0.8.5 for installation:
 
@@ -277,6 +358,7 @@ Run in interactive mode with the `lybic` backend:
 python gui_agents/cli_app.py --backend lybic
 ```
 
+
 Run a single query with the `pyautogui` backend and a maximum of 20 steps:
 ```sh
 python gui_agents/cli_app.py --backend pyautogui --query "Find the result of 8 × 7 on a calculator" --max-steps 20
@@ -308,6 +390,25 @@ LYBIC_MAX_LIFE_SECONDS=3600
 > LYBIC_PRECREATE_SID=SBX-XXXXXXXXXXXXXXX
 > ```
 
+### Use as a service
+
+After installing lybic-guiagents, you can run it as a service.
+
+Main Components:
+- AgentService: High-level service interface (recommended for most users)
+- AgentS2, AgentSFast: Core agent implementations  
+- HardwareInterface: Hardware abstraction layer
+- ServiceConfig: Configuration management
+
+Quick Start:
+
+```python
+from gui_agents import AgentService
+service = AgentService()
+result = service.execute_task("Take a screenshot")
+print(f"Task completed: {result.status}")
+```
+
 ### VMware Configuration
 
 To use PyAutoGUI with VMware, you need to install [VMware Workstation Pro](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion) (on Windows) and create a virtual machine. 
@@ -358,6 +459,7 @@ USE_PRECREATE_VM=Ubuntu
   ```bash
   uv sync
   uv pip install -e .
+  # uv pip install -e . -i  https://pypi.tuna.tsinghua.edu.cn/simple
   ```
 
 #### 3. Lybic Sandbox Connection Issues
@@ -406,6 +508,32 @@ If you encounter issues not covered here:
    - Complete error messages
    - Steps to reproduce the issue
 
+## 💬 Citations
+
+If you find this codebase useful, please cite:
+
+```bibtex
+@misc{guo2025agenticlybicmultiagentexecution,
+      title={Agentic Lybic: Multi-Agent Execution System with Tiered Reasoning and Orchestration}, 
+      author={Liangxuan Guo and Bin Zhu and Qingqian Tao and Kangning Liu and Xun Zhao and Xianzhe Qin and Jin Gao and Guangfu Hao},
+      year={2025},
+      eprint={2509.11067},
+      archivePrefix={arXiv},
+      primaryClass={cs.AI},
+      url={https://arxiv.org/abs/2509.11067}, 
+}
+```
+
+---
+
+## ❤️ Touch us:
+
+<div align="center" style="display: flex; justify-content: center; gap: 20px; flex-wrap: wrap;">
+  <img src="assets/feishu.png" alt="Lark Group" style="width: 200px; height: auto;"/>
+  <img src="assets/wechat.png" alt="WeChat Group" style="width: 200px; height: auto;"/>
+  <img src="assets/qq.png" alt="QQ Group" style="width: 200px; height: auto;"/>
+</div>
+
 ## Stargazers over time
 
 [![Stargazers over time](https://starchart.cc/lybic/agent.svg)](https://starchart.cc/lybic/agent)

{lybic_guiagents-0.1.0 → lybic_guiagents-0.2.1}/README.md

@@ -12,6 +12,19 @@
   Lybic GUI Agent: <small>An open-source agentic framework for Computer Use Agents</small> 
 </h1>
 
+<p align="center">
+    <small>Supported OS:</small>
+    <img src="https://img.shields.io/badge/OS-Windows-blue?logo=windows&logoColor=white" alt="Windows">
+    <img src="https://img.shields.io/badge/OS-macOS-black?logo=apple&logoColor=white" alt="macOS">
+    <img src="https://img.shields.io/badge/OS-Linux-yellow?logo=linux&logoColor=black" alt="Linux">
+    <br/>
+    <small>Latest Version:</small><a href="https://pypi.org/project/lybic-guiagents/"><img alt="PyPI" src="https://img.shields.io/pypi/v/lybic-guiagents"></a>
+    &nbsp;
+    <a href="https://github.com/lybic/agent/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/lybic-guiagents"></a>
+    &nbsp;
+    <a href="https://github.com/lybic/agent"><img alt="Stars" src="https://img.shields.io/github/stars/lybic/agent?style=social"></a>
+</p>
+
 ## What is Lybic GUI Agent?
 
 Lybic platform placeholder - comprehensive AI platform for building and deploying intelligent agents
@@ -27,6 +40,7 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 </div>
 
 ## 🥳 Updates
+- [x] **2025/09/14**: The paper has been accepted by [arxiv](https://arxiv.org/abs/2509.11067)
 - [x] **2025/09/09**: We achieved the world's first place in the 50-step length of [OS-world](https://os-world.github.io/)!
 - [x] **2025/08/08**: Released v0.1.0 of [Lybic GUI Agent](https://github.com/lybic/agent) library, with support for Windows, Mac, Ubuntu and Lybic API!
 
@@ -35,6 +49,8 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 1. [💡 Introduction](#-introduction)
 2. [🛠️ Installation & Setup](#%EF%B8%8F-installation--setup) 
 3. [🚀 Usage](#-usage)
+4. [🔧 Troubleshooting](#-troubleshooting)
+5. [💬 Citations](#-citations)
 
 ## 💡 Introduction
 
@@ -64,7 +80,7 @@ Lybic GUI Agent is an open-source framework that enables developers and business
     <tr>
       <td>OSWorld Verified (50 step)</td>
       <td><b>57.1%</b></td>
-      <td>53.1%</td>
+      <td>54.2%</td>
     </tr>
   </table>
 </div>
@@ -79,7 +95,15 @@ Lybic GUI Agent is an open-source framework that enables developers and business
 > [!WARNING]
 > To leverage the full potential of Lybic GUI Agent, we support multiple model providers including OpenAI, Anthropic, Gemini, and Doubao. For the best visual grounding performance, we recommend using UI-TARS models.
 
-### Installation
+### Installation(from pip)
+
+You can install Lybic GUI Agent by using pip:
+
+```bash
+pip install lybic-guiagents
+```
+
+### Installation(from source code)
 
 You can use [UV](https://docs.astral.sh/uv/getting-started/installation/) (a modern Python package manager) version 0.8.5 for installation:
 
@@ -180,6 +204,7 @@ Run in interactive mode with the `lybic` backend:
 python gui_agents/cli_app.py --backend lybic
 ```
 
+
 Run a single query with the `pyautogui` backend and a maximum of 20 steps:
 ```sh
 python gui_agents/cli_app.py --backend pyautogui --query "Find the result of 8 × 7 on a calculator" --max-steps 20
@@ -211,6 +236,25 @@ LYBIC_MAX_LIFE_SECONDS=3600
 > LYBIC_PRECREATE_SID=SBX-XXXXXXXXXXXXXXX
 > ```
 
+### Use as a service
+
+After installing lybic-guiagents, you can run it as a service.
+
+Main Components:
+- AgentService: High-level service interface (recommended for most users)
+- AgentS2, AgentSFast: Core agent implementations  
+- HardwareInterface: Hardware abstraction layer
+- ServiceConfig: Configuration management
+
+Quick Start:
+
+```python
+from gui_agents import AgentService
+service = AgentService()
+result = service.execute_task("Take a screenshot")
+print(f"Task completed: {result.status}")
+```
+
 ### VMware Configuration
 
 To use PyAutoGUI with VMware, you need to install [VMware Workstation Pro](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion) (on Windows) and create a virtual machine. 
@@ -261,6 +305,7 @@ USE_PRECREATE_VM=Ubuntu
   ```bash
   uv sync
   uv pip install -e .
+  # uv pip install -e . -i  https://pypi.tuna.tsinghua.edu.cn/simple
   ```
 
 #### 3. Lybic Sandbox Connection Issues
@@ -309,6 +354,32 @@ If you encounter issues not covered here:
    - Complete error messages
    - Steps to reproduce the issue
 
+## 💬 Citations
+
+If you find this codebase useful, please cite:
+
+```bibtex
+@misc{guo2025agenticlybicmultiagentexecution,
+      title={Agentic Lybic: Multi-Agent Execution System with Tiered Reasoning and Orchestration}, 
+      author={Liangxuan Guo and Bin Zhu and Qingqian Tao and Kangning Liu and Xun Zhao and Xianzhe Qin and Jin Gao and Guangfu Hao},
+      year={2025},
+      eprint={2509.11067},
+      archivePrefix={arXiv},
+      primaryClass={cs.AI},
+      url={https://arxiv.org/abs/2509.11067}, 
+}
+```
+
+---
+
+## ❤️ Touch us:
+
+<div align="center" style="display: flex; justify-content: center; gap: 20px; flex-wrap: wrap;">
+  <img src="assets/feishu.png" alt="Lark Group" style="width: 200px; height: auto;"/>
+  <img src="assets/wechat.png" alt="WeChat Group" style="width: 200px; height: auto;"/>
+  <img src="assets/qq.png" alt="QQ Group" style="width: 200px; height: auto;"/>
+</div>
+
 ## Stargazers over time
 
 [![Stargazers over time](https://starchart.cc/lybic/agent.svg)](https://starchart.cc/lybic/agent)

lybic_guiagents-0.2.1/gui_agents/__init__.py

@@ -0,0 +1,63 @@
+"""
+GUI Agents - A comprehensive GUI automation framework
+
+This package provides both low-level agent components and a high-level service interface
+for GUI automation tasks across different platforms and backends.
+
+Main Components:
+- AgentService: High-level service interface (recommended for most users)
+- AgentS2, AgentSFast: Core agent implementations  
+- HardwareInterface: Hardware abstraction layer
+- ServiceConfig: Configuration management
+
+Quick Start:
+    from gui_agents import AgentService
+    
+    service = AgentService()
+    result = service.execute_task("Take a screenshot")
+    print(f"Task completed: {result.status}")
+"""
+
+# High-level service interface (recommended)
+from .service import (
+    AgentService,
+    ServiceConfig, 
+    TaskRequest,
+    TaskResult,
+    TaskStatus,
+    ExecutionStats,
+    AgentServiceError,
+    ConfigurationError,
+    TaskExecutionError
+)
+
+# Core agent classes (for advanced users)
+from .agents.agent_s import AgentS2, AgentSFast
+from .agents.hardware_interface import HardwareInterface
+from .store.registry import Registry
+from .agents.global_state import GlobalState
+
+__version__ = "0.2.1"
+
+# Primary exports (what users should typically use)
+__all__ = [
+    # High-level service interface
+    "AgentService",
+    "ServiceConfig",
+    "TaskRequest", 
+    "TaskResult",
+    "TaskStatus", 
+    "ExecutionStats",
+    
+    # Exceptions
+    "AgentServiceError",
+    "ConfigurationError", 
+    "TaskExecutionError",
+    
+    # Core classes (for advanced usage)
+    "AgentS2",
+    "AgentSFast", 
+    "HardwareInterface",
+    "Registry",
+    "GlobalState",
+]

{lybic_guiagents-0.1.0 → lybic_guiagents-0.2.1}/gui_agents/agents/Action.py

@@ -27,9 +27,9 @@ The registry makes the last line work without an if‑else chain.
 """
 
 from abc import ABC
-from dataclasses import dataclass, field, fields, asdict
-from enum import Enum, auto
-from typing import Any, Dict, List, Tuple, Type, TypeVar, ClassVar
+from dataclasses import dataclass, field, fields
+from enum import Enum
+from typing import Any, Dict, List, Type, TypeVar, ClassVar
 
 __all__ = [
     "Action",

lybic_guiagents-0.2.1/gui_agents/agents/Backend/ADBBackend.py

@@ -0,0 +1,62 @@
+# ---------------------------------------------------------------------------
+# 2) Android device backend (ADB)
+# ---------------------------------------------------------------------------
+from gui_agents.agents.Action import (
+    Action,
+    Click,
+    Drag,
+    TypeText,
+    Scroll,
+    Hotkey,
+    Wait,
+)
+
+from gui_agents.agents.Backend.Backend import Backend
+import time
+import subprocess
+
+class ADBBackend(Backend):
+    """Very light‑weight ADB backend (tap / swipe / text / keyevent)."""
+
+    _supported = {Click, Drag, TypeText, Hotkey, Wait}
+
+    def __init__(self, serial: str | None = None):
+        self.serial = serial  # specify target device; None = default
+
+    # ------------------------------------------------------------------
+    def execute(self, action: Action) -> None:
+        if not self.supports(type(action)):
+            raise NotImplementedError
+
+        prefix = ["adb"]
+        if self.serial:
+            prefix += ["-s", self.serial]
+        prefix.append("shell")
+
+        if isinstance(action, Click):
+            cmd = prefix
+            # cmd = prefix + ["input", "tap", str(action.xy[0]), str(action.xy[1])]
+        elif isinstance(action, Drag):
+            cmd = prefix + [
+                "input", "swipe",
+                # str(action.start[0]), str(action.start[1]),
+                # str(action.end[0]), str(action.end[1]),
+                # str(int(action.duration * 1000)), # type: ignore
+            ]
+        elif isinstance(action, TypeText):
+            text = action.text.replace(" ", "%s")  # escape spaces
+            cmd = prefix + ["input", "text", text]
+            # if action.press_enter:
+            #     subprocess.run(prefix + ["input", "keyevent", "ENTER"], check=True)
+            #     return
+        elif isinstance(action, Hotkey):
+            # Map first key for demo purposes
+            key = action.keys[0].upper()
+            cmd = prefix + ["input", "keyevent", key]
+        elif isinstance(action, Wait):
+            time.sleep(action.seconds) # type: ignore
+            return
+        else:
+            raise NotImplementedError
+
+        subprocess.run(cmd, check=True)

lybic_guiagents-0.2.1/gui_agents/agents/Backend/Backend.py

@@ -0,0 +1,28 @@
+# Abstract backend base‑class
+# ---------------------------------------------------------------------------
+from abc import ABC, abstractmethod
+from typing import Any, List, Type, Dict, Set
+from gui_agents.agents.Action import (
+    Action
+)
+
+
+class Backend(ABC):
+    """Abstract base for platform back‑ends."""
+
+    #: Each backend advertises which Action subclasses it supports.
+    _supported: Set[Type[Action]] = set()
+
+    # ---------------------------------------------------------------------
+    def supports(self, action_type: Type[Action]) -> bool:
+        return action_type in self._supported
+
+    # ---------------------------------------------------------------------
+    @abstractmethod
+    def execute(self, action: Action) ->  Any:
+        """Translate an *Action* into concrete commands.
+
+        Should raise **NotImplementedError** if the *action* type is not in
+        `self._supported`, so upper layers can decide how to degrade / retry.
+        """
+