agentscope-runtime 0.1.5b1__tar.gz → 0.1.6__tar.gz

{agentscope_runtime-0.1.5b1/src/agentscope_runtime.egg-info → agentscope_runtime-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentscope-runtime
-Version: 0.1.5b1
+Version: 0.1.6
 Summary: A production-ready runtime framework for agent applications, providing secure sandboxed execution environments and scalable deployment solutions with multi-framework support.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -8,9 +8,17 @@ License-File: LICENSE
 Requires-Dist: mcp>=1.13
 Requires-Dist: fastapi>=0.104.0
 Requires-Dist: uvicorn[standard]>=0.24.0
-Requires-Dist: openai>=1.108.1
+Requires-Dist: openai
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: requests>=2.32.4
+Requires-Dist: agentscope>=1.0.6
+Requires-Dist: docker>=7.1.0
+Requires-Dist: redis>=6.0.0
+Requires-Dist: oss2>=2.19.1
+Requires-Dist: pydantic-settings>=2.9.1
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: kubernetes>=33.1.0
+Requires-Dist: shortuuid>=1.0.13
 Provides-Extra: dev
 Requires-Dist: pytest>=8.3.5; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
@@ -20,17 +28,6 @@ Requires-Dist: furo>=2025.7.19; extra == "dev"
 Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
 Requires-Dist: fakeredis>=2.31.0; extra == "dev"
 Requires-Dist: sphinx-autoapi>=3.6.0; extra == "dev"
-Provides-Extra: sandbox
-Requires-Dist: docker>=7.1.0; extra == "sandbox"
-Requires-Dist: steel-sdk>=0.1.0; extra == "sandbox"
-Requires-Dist: redis>=6.0.0b2; extra == "sandbox"
-Requires-Dist: oss2>=2.19.1; extra == "sandbox"
-Requires-Dist: pydantic-settings>=2.9.1; extra == "sandbox"
-Requires-Dist: dotenv>=0.9.9; extra == "sandbox"
-Requires-Dist: kubernetes>=33.1.0; extra == "sandbox"
-Requires-Dist: shortuuid>=1.0.13; extra == "sandbox"
-Provides-Extra: agentscope
-Requires-Dist: agentscope>=1.0.1; extra == "agentscope"
 Provides-Extra: langgraph
 Requires-Dist: langgraph>=0.5.3; extra == "langgraph"
 Provides-Extra: agno
@@ -40,38 +37,30 @@ Requires-Dist: a2a-sdk>=0.3.0; extra == "a2a"
 Provides-Extra: autogen
 Requires-Dist: autogen-agentchat>=0.7.4; extra == "autogen"
 Requires-Dist: autogen-ext[openai]>=0.7.4; extra == "autogen"
+Provides-Extra: agentrun
+Requires-Dist: alibabacloud-agentrun20250910>=1.0.0; extra == "agentrun"
+Requires-Dist: alibabacloud_tea_openapi>=0.4.0; extra == "agentrun"
 Provides-Extra: langchain-rag
 Requires-Dist: langchain>=0.3.25; extra == "langchain-rag"
-Requires-Dist: pymilvus>=2.6.0; extra == "langchain-rag"
+Requires-Dist: pymilvus[milvus-lite]>=2.6.0; extra == "langchain-rag"
 Requires-Dist: langchain-community>=0.3.27; extra == "langchain-rag"
 Requires-Dist: langchain-milvus>=0.2.1; extra == "langchain-rag"
 Requires-Dist: bs4>=0.0.2; extra == "langchain-rag"
 Provides-Extra: llamaindex-rag
 Requires-Dist: llama-index>=0.13.4; extra == "llamaindex-rag"
-Requires-Dist: pymilvus>=2.6.0; extra == "llamaindex-rag"
+Requires-Dist: pymilvus[milvus-lite]>=2.6.0; extra == "llamaindex-rag"
 Requires-Dist: llama-index-vector-stores-milvus>=0.9.1; extra == "llamaindex-rag"
 Requires-Dist: llama-index-readers-web>=0.5.1; extra == "llamaindex-rag"
 Requires-Dist: llama-index-embeddings-langchain>=0.4.0; extra == "llamaindex-rag"
-Requires-Dist: langchain-community>=0.3.27; extra == "llamaindex-rag"
+Requires-Dist: llama-index-embeddings-dashscope>=0.4.0; extra == "llamaindex-rag"
 Requires-Dist: bs4>=0.0.2; extra == "llamaindex-rag"
+Provides-Extra: aliyun-tablestore-ext
+Requires-Dist: tablestore-for-agent-memory>=1.1.0; extra == "aliyun-tablestore-ext"
+Requires-Dist: dashscope>=1.24.4; extra == "aliyun-tablestore-ext"
+Requires-Dist: langchain-community>=0.3.27; extra == "aliyun-tablestore-ext"
 Provides-Extra: memory-ext
 Requires-Dist: reme-ai==0.1.9; python_full_version >= "3.12" and extra == "memory-ext"
 Requires-Dist: mem0ai>=0.1.117; extra == "memory-ext"
-Provides-Extra: deployment
-Requires-Dist: alibabacloud-oss-v2; extra == "deployment"
-Requires-Dist: alibabacloud-bailian20231229>=2.5.0; extra == "deployment"
-Requires-Dist: build; extra == "deployment"
-Requires-Dist: setuptools>=40.8.0; extra == "deployment"
-Requires-Dist: wheel; extra == "deployment"
-Requires-Dist: steel-sdk>=0.1.0; extra == "deployment"
-Requires-Dist: alibabacloud-credentials; extra == "deployment"
-Requires-Dist: jinja2; extra == "deployment"
-Requires-Dist: psutil; extra == "deployment"
-Requires-Dist: shortuuid>=1.0.13; extra == "deployment"
-Requires-Dist: docker>=7.1.0; extra == "deployment"
-Requires-Dist: kubernetes>=33.1.0; extra == "deployment"
-Requires-Dist: PyYAML; extra == "deployment"
-Requires-Dist: oss2>=2.19.1; extra == "deployment"
 Dynamic: license-file
 
 <div align="center">
@@ -79,8 +68,9 @@ Dynamic: license-file
 # AgentScope Runtime
 
 [![PyPI](https://img.shields.io/pypi/v/agentscope-runtime?label=PyPI&color=brightgreen&logo=python)](https://pypi.org/project/agentscope-runtime/)
+[![Downloads](https://static.pepy.tech/badge/agentscope-runtime)](https://pepy.tech/project/agentscope-runtime)
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg?logo=python&label=Python)](https://python.org)
-[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=Liscnese)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=License)](LICENSE)
 [![Code Style](https://img.shields.io/badge/code%20style-black-black.svg?logo=python&label=CodeStyle)](https://github.com/psf/black)
 [![GitHub Stars](https://img.shields.io/github/stars/agentscope-ai/agentscope-runtime?style=flat&logo=github&color=yellow&label=Stars)](https://github.com/agentscope-ai/agentscope-runtime/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/agentscope-ai/agentscope-runtime?style=flat&logo=github&color=purple&label=Forks)](https://github.com/agentscope-ai/agentscope-runtime/network)
@@ -94,6 +84,7 @@ Dynamic: license-file
 
 [[Cookbook]](https://runtime.agentscope.io/)
 [[中文README]](README_zh.md)
+[[Samples]](https://github.com/agentscope-ai/agentscope-samples)
 
 **A Production-Ready Runtime Framework for Intelligent Agent Applications**
 
@@ -103,6 +94,12 @@ Dynamic: license-file
 
 ---
 
+## 🆕 NEWS
+
+* **[2025-10]**  **GUI Sandbox** is added with support for virtual desktop environments, mouse, keyboard, and screen operations.  Introduced the **`desktop_url`** property for GUI Sandbox, Browser Sandbox, and Filesystem Sandbox — allowing direct access to the virtual desktop via your browser.  Check our [cookbook](https://runtime.agentscope.io/en/sandbox.html#sandbox-usage) for more details.
+
+---
+
 ## ✨ Key Features
 
 - **🏗️ Deployment Infrastructure**: Built-in services for session management, memory, and sandbox environment control
@@ -150,9 +147,6 @@ From PyPI:
 ```bash
 # Install core dependencies
 pip install agentscope-runtime
-
-# Install sandbox dependencies
-pip install "agentscope-runtime[sandbox]"
 ```
 
 (Optional) From source:
@@ -164,35 +158,41 @@ cd agentscope-runtime
 
 # Install core dependencies
 pip install -e .
-
-# Install sandbox dependencies
-pip install -e ".[sandbox]"
 ```
 
 ### Basic Agent Usage Example
 
-This example demonstrates how to create a simple LLM agent using AgentScope Runtime and stream responses from the Qwen model.
+This example demonstrates how to create an agentscope agent using AgentScope Runtime and
+stream responses from the Qwen model.
+
 
 ```python
 import asyncio
 import os
+
 from agentscope_runtime.engine import Runner
-from agentscope_runtime.engine.agents.llm_agent import LLMAgent
-from agentscope_runtime.engine.llms import QwenLLM
+from agentscope_runtime.engine.agents.agentscope_agent import AgentScopeAgent
 from agentscope_runtime.engine.schemas.agent_schemas import AgentRequest
 from agentscope_runtime.engine.services.context_manager import ContextManager
 
+from agentscope.agent import ReActAgent
+from agentscope.model import OpenAIChatModel
 
 async def main():
     # Set up the language model and agent
-    model = QwenLLM(
-        model_name="qwen-turbo",
-        api_key=os.getenv("DASHSCOPE_API_KEY"),
+    agent = AgentScopeAgent(
+        name="Friday",
+        model=OpenAIChatModel(
+            "gpt-4",
+            api_key=os.getenv("OPENAI_API_KEY"),
+        ),
+        agent_config={
+            "sys_prompt": "You're a helpful assistant named Friday.",
+        },
+        agent_builder=ReActAgent,
     )
-    llm_agent = LLMAgent(model=model, name="llm_agent")
-
     async with ContextManager() as context_manager:
-        runner = Runner(agent=llm_agent, context_manager=context_manager)
+        runner = Runner(agent=agent, context_manager=context_manager)
 
         # Create a request and stream the response
         request = AgentRequest(
@@ -219,19 +219,128 @@ asyncio.run(main())
 
 ### Basic Sandbox Usage Example
 
-This example demonstrates how to create sandboxed and execute tool within the sandbox.
+These examples demonstrate how to create sandboxed environments and execute tools within them, with some examples featuring interactive frontend interfaces accessible via VNC (Virtual Network Computing):
+
+> [!NOTE]
+>
+> Current version requires Docker or Kubernetes to be installed and running on your system. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
+>
+> If you plan to use the sandbox on a large scale in production, we recommend deploying it directly in Alibaba Cloud for managed hosting: [One-click deploy sandbox on Alibaba Cloud](https://computenest.console.aliyun.com/service/instance/create/default?ServiceName=AgentScope%20Runtime%20%E6%B2%99%E7%AE%B1%E7%8E%AF%E5%A2%83)
+
+#### Base Sandbox
+
+Use for running **Python code** or **shell commands** in an isolated environment.
 
 ```python
 from agentscope_runtime.sandbox import BaseSandbox
 
 with BaseSandbox() as box:
-    print(box.run_ipython_cell(code="print('hi')"))
-    print(box.run_shell_command(command="echo hello"))
+    # By default, pulls `agentscope/runtime-sandbox-base:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.run_ipython_cell(code="print('hi')"))  # Run Python code
+    print(box.run_shell_command(command="echo hello"))  # Run shell command
+    input("Press Enter to continue...")
 ```
 
-> [!NOTE]
->
-> Current version requires Docker or Kubernetes to be installed and running on your system. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
+#### GUI Sandbox
+
+Provides a **virtual desktop** environment for mouse, keyboard, and screen operations.
+
+<img src="https://img.alicdn.com/imgextra/i2/O1CN01df5SaM1xKFQP4KGBW_!!6000000006424-2-tps-2958-1802.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import GuiSandbox
+
+with GuiSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-gui:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    print(box.computer_use(action="get_cursor_position"))  # Get mouse cursor position
+    print(box.computer_use(action="get_screenshot"))       # Capture screenshot
+    input("Press Enter to continue...")
+```
+
+#### Browser Sandbox
+
+A GUI-based sandbox with **browser operations** inside an isolated sandbox.
+
+<img src="https://img.alicdn.com/imgextra/i4/O1CN01OIq1dD1gAJMcm0RFR_!!6000000004101-2-tps-2734-1684.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import BrowserSandbox
+
+with BrowserSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    box.browser_navigate("https://www.google.com/")  # Open a webpage
+    input("Press Enter to continue...")
+```
+
+#### Filesystem Sandbox
+
+A GUI-based sandbox with **file system operations** such as creating, reading, and deleting files.
+
+<img src="https://img.alicdn.com/imgextra/i3/O1CN01VocM961vK85gWbJIy_!!6000000006153-2-tps-2730-1686.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import FilesystemSandbox
+
+with FilesystemSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    box.create_directory("test")  # Create a directory
+    input("Press Enter to continue...")
+```
+
+#### Configuring Sandbox Image Registry, Namespace, and Tag
+
+##### 1. Registry
+
+If pulling images from DockerHub fails (for example, due to network restrictions), you can switch the image source to Alibaba Cloud Container Registry for faster access:
+
+```bash
+export RUNTIME_SANDBOX_REGISTRY="agentscope-registry.ap-southeast-1.cr.aliyuncs.com"
+```
+
+##### 2. Namespace
+
+A namespace is used to distinguish images of different teams or projects. You can customize the namespace via an environment variable:
+
+```bash
+export RUNTIME_SANDBOX_IMAGE_NAMESPACE="agentscope"
+```
+
+For example, here `agentscope` will be used as part of the image path.
+
+##### 3. Tag
+
+An image tag specifies the version of the image, for example:
+
+```bash
+export RUNTIME_SANDBOX_IMAGE_TAG="preview"
+```
+
+Details:
+
+- Default is `latest`, which means the image version matches the PyPI latest release.
+- `preview` means the latest preview version built in sync with the **GitHub main branch**.
+- You can also use a specified version number such as `20250909`. You can check all available image versions at [DockerHub](https://hub.docker.com/repositories/agentscope).
+
+##### 4. Complete Image Path
+
+The sandbox SDK will build the full image path based on the above environment variables:
+
+```bash
+<RUNTIME_SANDBOX_REGISTRY>/<RUNTIME_SANDBOX_IMAGE_NAMESPACE>/runtime-sandbox-base:<RUNTIME_SANDBOX_IMAGE_TAG>
+```
+
+Example:
+
+```bash
+agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/runtime-sandbox-base:preview
+```
 
 ---
 
@@ -247,29 +356,6 @@ with BaseSandbox() as box:
 
 ## 🔌 Agent Framework Integration
 
-### AgentScope Integration
-
-```python
-# pip install "agentscope-runtime[agentscope]"
-import os
-
-from agentscope.agent import ReActAgent
-from agentscope.model import OpenAIChatModel
-from agentscope_runtime.engine.agents.agentscope_agent import AgentScopeAgent
-
-agent = AgentScopeAgent(
-    name="Friday",
-    model=OpenAIChatModel(
-        "gpt-4",
-        api_key=os.getenv("OPENAI_API_KEY"),
-    ),
-    agent_config={
-        "sys_prompt": "You're a helpful assistant named {name}.",
-    },
-    agent_builder=ReActAgent,
-)
-```
-
 ### Agno Integration
 
 ```python
@@ -421,7 +507,7 @@ limitations under the License.
 
 ## Contributors ✨
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-9-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -443,6 +529,11 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Osier-Yi"><img src="https://avatars.githubusercontent.com/u/8287381?v=4?s=100" width="100px;" alt="Osier-Yi"/><br /><sub><b>Osier-Yi</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Osier-Yi" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Osier-Yi" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/kevinlin09"><img src="https://avatars.githubusercontent.com/u/26913335?v=4?s=100" width="100px;" alt="Kevin Lin"/><br /><sub><b>Kevin Lin</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=kevinlin09" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://davdgao.github.io/"><img src="https://avatars.githubusercontent.com/u/102287034?v=4?s=100" width="100px;" alt="DavdGao"/><br /><sub><b>DavdGao</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/pulls?q=is%3Apr+reviewed-by%3ADavdGao" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/FLyLeaf-coder"><img src="https://avatars.githubusercontent.com/u/122603493?v=4?s=100" width="100px;" alt="FlyLeaf"/><br /><sub><b>FlyLeaf</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=FLyLeaf-coder" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=FLyLeaf-coder" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jinghuan-Chen"><img src="https://avatars.githubusercontent.com/u/42742857?v=4?s=100" width="100px;" alt="jinghuan-Chen"/><br /><sub><b>jinghuan-Chen</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=jinghuan-Chen" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Sodawyx"><img src="https://avatars.githubusercontent.com/u/34974468?v=4?s=100" width="100px;" alt="Yuxuan Wu"/><br /><sub><b>Yuxuan Wu</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Sodawyx" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Sodawyx" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/TianYu92"><img src="https://avatars.githubusercontent.com/u/12960468?v=4?s=100" width="100px;" alt="Fear1es5"/><br /><sub><b>Fear1es5</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3ATianYu92" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>
   <tfoot>

{agentscope_runtime-0.1.5b1 → agentscope_runtime-0.1.6}/README.md

@@ -3,8 +3,9 @@
 # AgentScope Runtime
 
 [![PyPI](https://img.shields.io/pypi/v/agentscope-runtime?label=PyPI&color=brightgreen&logo=python)](https://pypi.org/project/agentscope-runtime/)
+[![Downloads](https://static.pepy.tech/badge/agentscope-runtime)](https://pepy.tech/project/agentscope-runtime)
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg?logo=python&label=Python)](https://python.org)
-[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=Liscnese)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=License)](LICENSE)
 [![Code Style](https://img.shields.io/badge/code%20style-black-black.svg?logo=python&label=CodeStyle)](https://github.com/psf/black)
 [![GitHub Stars](https://img.shields.io/github/stars/agentscope-ai/agentscope-runtime?style=flat&logo=github&color=yellow&label=Stars)](https://github.com/agentscope-ai/agentscope-runtime/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/agentscope-ai/agentscope-runtime?style=flat&logo=github&color=purple&label=Forks)](https://github.com/agentscope-ai/agentscope-runtime/network)
@@ -18,6 +19,7 @@
 
 [[Cookbook]](https://runtime.agentscope.io/)
 [[中文README]](README_zh.md)
+[[Samples]](https://github.com/agentscope-ai/agentscope-samples)
 
 **A Production-Ready Runtime Framework for Intelligent Agent Applications**
 
@@ -27,6 +29,12 @@
 
 ---
 
+## 🆕 NEWS
+
+* **[2025-10]**  **GUI Sandbox** is added with support for virtual desktop environments, mouse, keyboard, and screen operations.  Introduced the **`desktop_url`** property for GUI Sandbox, Browser Sandbox, and Filesystem Sandbox — allowing direct access to the virtual desktop via your browser.  Check our [cookbook](https://runtime.agentscope.io/en/sandbox.html#sandbox-usage) for more details.
+
+---
+
 ## ✨ Key Features
 
 - **🏗️ Deployment Infrastructure**: Built-in services for session management, memory, and sandbox environment control
@@ -74,9 +82,6 @@ From PyPI:
 ```bash
 # Install core dependencies
 pip install agentscope-runtime
-
-# Install sandbox dependencies
-pip install "agentscope-runtime[sandbox]"
 ```
 
 (Optional) From source:
@@ -88,35 +93,41 @@ cd agentscope-runtime
 
 # Install core dependencies
 pip install -e .
-
-# Install sandbox dependencies
-pip install -e ".[sandbox]"
 ```
 
 ### Basic Agent Usage Example
 
-This example demonstrates how to create a simple LLM agent using AgentScope Runtime and stream responses from the Qwen model.
+This example demonstrates how to create an agentscope agent using AgentScope Runtime and
+stream responses from the Qwen model.
+
 
 ```python
 import asyncio
 import os
+
 from agentscope_runtime.engine import Runner
-from agentscope_runtime.engine.agents.llm_agent import LLMAgent
-from agentscope_runtime.engine.llms import QwenLLM
+from agentscope_runtime.engine.agents.agentscope_agent import AgentScopeAgent
 from agentscope_runtime.engine.schemas.agent_schemas import AgentRequest
 from agentscope_runtime.engine.services.context_manager import ContextManager
 
+from agentscope.agent import ReActAgent
+from agentscope.model import OpenAIChatModel
 
 async def main():
     # Set up the language model and agent
-    model = QwenLLM(
-        model_name="qwen-turbo",
-        api_key=os.getenv("DASHSCOPE_API_KEY"),
+    agent = AgentScopeAgent(
+        name="Friday",
+        model=OpenAIChatModel(
+            "gpt-4",
+            api_key=os.getenv("OPENAI_API_KEY"),
+        ),
+        agent_config={
+            "sys_prompt": "You're a helpful assistant named Friday.",
+        },
+        agent_builder=ReActAgent,
     )
-    llm_agent = LLMAgent(model=model, name="llm_agent")
-
     async with ContextManager() as context_manager:
-        runner = Runner(agent=llm_agent, context_manager=context_manager)
+        runner = Runner(agent=agent, context_manager=context_manager)
 
         # Create a request and stream the response
         request = AgentRequest(
@@ -143,19 +154,128 @@ asyncio.run(main())
 
 ### Basic Sandbox Usage Example
 
-This example demonstrates how to create sandboxed and execute tool within the sandbox.
+These examples demonstrate how to create sandboxed environments and execute tools within them, with some examples featuring interactive frontend interfaces accessible via VNC (Virtual Network Computing):
+
+> [!NOTE]
+>
+> Current version requires Docker or Kubernetes to be installed and running on your system. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
+>
+> If you plan to use the sandbox on a large scale in production, we recommend deploying it directly in Alibaba Cloud for managed hosting: [One-click deploy sandbox on Alibaba Cloud](https://computenest.console.aliyun.com/service/instance/create/default?ServiceName=AgentScope%20Runtime%20%E6%B2%99%E7%AE%B1%E7%8E%AF%E5%A2%83)
+
+#### Base Sandbox
+
+Use for running **Python code** or **shell commands** in an isolated environment.
 
 ```python
 from agentscope_runtime.sandbox import BaseSandbox
 
 with BaseSandbox() as box:
-    print(box.run_ipython_cell(code="print('hi')"))
-    print(box.run_shell_command(command="echo hello"))
+    # By default, pulls `agentscope/runtime-sandbox-base:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.run_ipython_cell(code="print('hi')"))  # Run Python code
+    print(box.run_shell_command(command="echo hello"))  # Run shell command
+    input("Press Enter to continue...")
 ```
 
-> [!NOTE]
->
-> Current version requires Docker or Kubernetes to be installed and running on your system. Please refer to [this tutorial](https://runtime.agentscope.io/en/sandbox.html) for more details.
+#### GUI Sandbox
+
+Provides a **virtual desktop** environment for mouse, keyboard, and screen operations.
+
+<img src="https://img.alicdn.com/imgextra/i2/O1CN01df5SaM1xKFQP4KGBW_!!6000000006424-2-tps-2958-1802.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import GuiSandbox
+
+with GuiSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-gui:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    print(box.computer_use(action="get_cursor_position"))  # Get mouse cursor position
+    print(box.computer_use(action="get_screenshot"))       # Capture screenshot
+    input("Press Enter to continue...")
+```
+
+#### Browser Sandbox
+
+A GUI-based sandbox with **browser operations** inside an isolated sandbox.
+
+<img src="https://img.alicdn.com/imgextra/i4/O1CN01OIq1dD1gAJMcm0RFR_!!6000000004101-2-tps-2734-1684.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import BrowserSandbox
+
+with BrowserSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-browser:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    box.browser_navigate("https://www.google.com/")  # Open a webpage
+    input("Press Enter to continue...")
+```
+
+#### Filesystem Sandbox
+
+A GUI-based sandbox with **file system operations** such as creating, reading, and deleting files.
+
+<img src="https://img.alicdn.com/imgextra/i3/O1CN01VocM961vK85gWbJIy_!!6000000006153-2-tps-2730-1686.png" alt="GUI Sandbox" width="800" height="500">
+
+```python
+from agentscope_runtime.sandbox import FilesystemSandbox
+
+with FilesystemSandbox() as box:
+    # By default, pulls `agentscope/runtime-sandbox-filesystem:latest` from DockerHub
+    print(box.list_tools()) # List all available tools
+    print(box.desktop_url)  # Web desktop access URL
+    box.create_directory("test")  # Create a directory
+    input("Press Enter to continue...")
+```
+
+#### Configuring Sandbox Image Registry, Namespace, and Tag
+
+##### 1. Registry
+
+If pulling images from DockerHub fails (for example, due to network restrictions), you can switch the image source to Alibaba Cloud Container Registry for faster access:
+
+```bash
+export RUNTIME_SANDBOX_REGISTRY="agentscope-registry.ap-southeast-1.cr.aliyuncs.com"
+```
+
+##### 2. Namespace
+
+A namespace is used to distinguish images of different teams or projects. You can customize the namespace via an environment variable:
+
+```bash
+export RUNTIME_SANDBOX_IMAGE_NAMESPACE="agentscope"
+```
+
+For example, here `agentscope` will be used as part of the image path.
+
+##### 3. Tag
+
+An image tag specifies the version of the image, for example:
+
+```bash
+export RUNTIME_SANDBOX_IMAGE_TAG="preview"
+```
+
+Details:
+
+- Default is `latest`, which means the image version matches the PyPI latest release.
+- `preview` means the latest preview version built in sync with the **GitHub main branch**.
+- You can also use a specified version number such as `20250909`. You can check all available image versions at [DockerHub](https://hub.docker.com/repositories/agentscope).
+
+##### 4. Complete Image Path
+
+The sandbox SDK will build the full image path based on the above environment variables:
+
+```bash
+<RUNTIME_SANDBOX_REGISTRY>/<RUNTIME_SANDBOX_IMAGE_NAMESPACE>/runtime-sandbox-base:<RUNTIME_SANDBOX_IMAGE_TAG>
+```
+
+Example:
+
+```bash
+agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/runtime-sandbox-base:preview
+```
 
 ---
 
@@ -171,29 +291,6 @@ with BaseSandbox() as box:
 
 ## 🔌 Agent Framework Integration
 
-### AgentScope Integration
-
-```python
-# pip install "agentscope-runtime[agentscope]"
-import os
-
-from agentscope.agent import ReActAgent
-from agentscope.model import OpenAIChatModel
-from agentscope_runtime.engine.agents.agentscope_agent import AgentScopeAgent
-
-agent = AgentScopeAgent(
-    name="Friday",
-    model=OpenAIChatModel(
-        "gpt-4",
-        api_key=os.getenv("OPENAI_API_KEY"),
-    ),
-    agent_config={
-        "sys_prompt": "You're a helpful assistant named {name}.",
-    },
-    agent_builder=ReActAgent,
-)
-```
-
 ### Agno Integration
 
 ```python
@@ -345,7 +442,7 @@ limitations under the License.
 
 ## Contributors ✨
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-9-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -367,6 +464,11 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Osier-Yi"><img src="https://avatars.githubusercontent.com/u/8287381?v=4?s=100" width="100px;" alt="Osier-Yi"/><br /><sub><b>Osier-Yi</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Osier-Yi" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Osier-Yi" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/kevinlin09"><img src="https://avatars.githubusercontent.com/u/26913335?v=4?s=100" width="100px;" alt="Kevin Lin"/><br /><sub><b>Kevin Lin</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=kevinlin09" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://davdgao.github.io/"><img src="https://avatars.githubusercontent.com/u/102287034?v=4?s=100" width="100px;" alt="DavdGao"/><br /><sub><b>DavdGao</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/pulls?q=is%3Apr+reviewed-by%3ADavdGao" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/FLyLeaf-coder"><img src="https://avatars.githubusercontent.com/u/122603493?v=4?s=100" width="100px;" alt="FlyLeaf"/><br /><sub><b>FlyLeaf</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=FLyLeaf-coder" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=FLyLeaf-coder" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jinghuan-Chen"><img src="https://avatars.githubusercontent.com/u/42742857?v=4?s=100" width="100px;" alt="jinghuan-Chen"/><br /><sub><b>jinghuan-Chen</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=jinghuan-Chen" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Sodawyx"><img src="https://avatars.githubusercontent.com/u/34974468?v=4?s=100" width="100px;" alt="Yuxuan Wu"/><br /><sub><b>Yuxuan Wu</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Sodawyx" title="Code">💻</a> <a href="https://github.com/agentscope-ai/agentscope-runtime/commits?author=Sodawyx" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/TianYu92"><img src="https://avatars.githubusercontent.com/u/12960468?v=4?s=100" width="100px;" alt="Fear1es5"/><br /><sub><b>Fear1es5</b></sub></a><br /><a href="https://github.com/agentscope-ai/agentscope-runtime/issues?q=author%3ATianYu92" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>
   <tfoot>