Auto-commit: README.md updated

README.md

@@ -1,166 +1,329 @@
----------
+------------
 
 title: Landrun Sandbox + Browser Automation
 
-emoji: 🔒title: Landrun Sandbox + Browser Automationtitle: Docker Sandbox
+emoji: 🔒title: Landrun Sandbox + Browser Automation
 
 colorFrom: purple
 
-colorTo: blueemoji: 🔒🌐emoji: 🐳
+colorTo: blueemoji: 🔒title: Landrun Sandbox + Browser Automationtitle: Docker Sandbox
 
 sdk: docker
 
-app_file: app.pycolorFrom: purplecolorFrom: blue
+app_file: app.pycolorFrom: purple
 
 pinned: false
 
-license: mitcolorTo: bluecolorTo: purple
+license: mitcolorTo: blueemoji: 🔒🌐emoji: 🐳
 
 ---
 
-sdk: dockersdk: docker
+sdk: docker
 
 # 🔒 Landrun Sandbox + Browser Automation
 
-pinned: truepinned: false
+app_file: app.pycolorFrom: purplecolorFrom: blue
 
 **Kernel-Level Code Execution Sandbox with Automated UI Testing**
 
-license: mitlicense: mit
+pinned: false
 
 Execute code with maximum security using **Landrun** (Linux Landlock kernel security) and automatically test UIs with **Playwright** browser automation.
 
-------
+license: mitcolorTo: bluecolorTo: purple
 
 ## ✨ Features
 
-
+---
 
 ### 🔒 Landrun Security
 
-- **Kernel-level isolation** using Linux Landlock LSM# 🔒 Landrun Sandbox + Browser Automation# 🐳 Docker Sandbox Executor
+sdk: dockersdk: docker
 
-- **Zero-trust execution** with restricted filesystem access
+- **Kernel-level isolation** using Linux Landlock LSM
 
-- **Read-only system files** - only `/tmp/sandbox` is writable
+- **Zero-trust execution** with restricted filesystem access# 🔒 Landrun Sandbox + Browser Automation
 
-- **Network restrictions** - only HTTP/HTTPS allowed
+- **Read-only system files** - only `/tmp/sandbox` is writable
 
-- **10-second timeout** protection**Kernel-Level Code Execution Sandbox + Automated UI Testing****Secure code execution in isolated Docker containers**
+- **Network restrictions** - only HTTP/HTTPS allowedpinned: truepinned: false
 
+- **10-second timeout** protection
 
+**Kernel-Level Code Execution Sandbox with Automated UI Testing**
 
 ### 🌐 Browser Automation
 
+license: mitlicense: mit
+
 - **Playwright Chromium** for automated UI testing
 
-- **Screenshot capture** before/after actionsExecute code with maximum security using **Landrun** (Linux Landlock kernel security) and automatically test UIs with **Playwright** browser automation.## Features
+- **Screenshot capture** before/after actionsExecute code with maximum security using **Landrun** (Linux Landlock kernel security) and automatically test UIs with **Playwright** browser automation.
 
 - **Element interaction** - click, type, wait, get text
 
-- **One-shot API** - execute code → test UI → get results
+- **One-shot API** - execute code → test UI → get results------
 
 
 
-### 🚀 Supported Languages## ✨ Features✅ **Isolated execution** - Each code run in separate container  
+### 🚀 Supported Languages## ✨ Features
 
-- **Python 3.11** - with stdlib + compilers (gcc, g++)
 
-- **JavaScript (Node.js)** - server-side execution✅ **Resource limits** - 256MB RAM, 50% CPU per execution  
 
-- **React (JSX)** - client-side components with live preview
+- **Python 3.11** - with stdlib + compilers (gcc, g++)
 
-- **HTML + CSS** - static pages with full styling### 🔒 Landrun Security✅ **Network disabled** - Maximum security  
+- **JavaScript (Node.js)** - server-side execution
 
+- **React (JSX)** - client-side components with live preview### 🔒 Landrun Security
 
+- **HTML + CSS** - static pages with full styling
+
+- **Kernel-level isolation** using Linux Landlock LSM# 🔒 Landrun Sandbox + Browser Automation# 🐳 Docker Sandbox Executor
 
-## 📡 API Endpoints- **Kernel-level isolation** using Linux Landlock LSM✅ **Auto-cleanup** - Containers destroyed after execution  
+## 📡 API Endpoints
 
+- **Zero-trust execution** with restricted filesystem access
 
+### 1. Execute Code
 
-### 1. Execute Code- **Zero-trust execution** with restricted filesystem access✅ **Multiple languages** - Python, JavaScript, React, HTML
+- **Read-only system files** - only `/tmp/sandbox` is writable
 
 ```bash
 
-POST /execute- **Read-only system files** - only `/tmp/sandbox` is writable
+POST /execute- **Network restrictions** - only HTTP/HTTPS allowed
 
 Content-Type: application/json
 
-- **Network restrictions** - only HTTP/HTTPS allowed## Architecture
+- **10-second timeout** protection**Kernel-Level Code Execution Sandbox + Automated UI Testing****Secure code execution in isolated Docker containers**
 
 {
 
-  "language": "react",- **10-second timeout** protection
+  "language": "react",
 
   "code": "export default function App() { return <h1>Hello!</h1>; }"
 
-}```
+}### 🌐 Browser Automation
 
 ```
 
-### 🌐 Browser Automation┌─────────────────────────────────────────────────────┐
+- **Playwright Chromium** for automated UI testing
 
 ### 2. Get Live Preview
 
-```bash- **Playwright Chromium** for automated UI testing│         Hugging Face Space (Docker SDK)             │
+- **Screenshot capture** before/after actionsExecute code with maximum security using **Landrun** (Linux Landlock kernel security) and automatically test UIs with **Playwright** browser automation.## Features
 
-GET /preview/{uuid}
+```bash
+
+GET /preview/{uuid}- **Element interaction** - click, type, wait, get text
 
-```- **Screenshot capture** before/after actions│                                                      │
+```
+
+- **One-shot API** - execute code → test UI → get results
 
+### 3. Test UI with Browser
 
 
-### 3. Test UI with Browser- **Element interaction** - click, type, wait│  ┌──────────────────────────────────────────────┐  │
 
 ```bash
 
-POST /browser/test- **Text extraction** from elements│  │     FastAPI Server (app_docker.py)           │  │
+POST /browser/test### 🚀 Supported Languages## ✨ Features✅ **Isolated execution** - Each code run in separate container  
 
 Content-Type: application/json
 
-- **One-shot API** - execute code → test UI → get results│  │                                               │  │
+- **Python 3.11** - with stdlib + compilers (gcc, g++)
 
 {
 
-  "preview_url": "/preview/uuid",│  │  ┌────────────────────────────────────────┐  │  │
+  "preview_url": "/preview/uuid",- **JavaScript (Node.js)** - server-side execution✅ **Resource limits** - 256MB RAM, 50% CPU per execution  
 
   "actions": [
 
-    {"type": "click", "selector": "button"},### 🚀 Supported Languages│  │  │  Docker Engine (in Space)              │  │  │
+    {"type": "click", "selector": "button"},- **React (JSX)** - client-side components with live preview
 
     {"type": "screenshot"}
 
-  ]- **Python 3.11** - with stdlib + compilers│  │  │                                         │  │  │
+  ]- **HTML + CSS** - static pages with full styling### 🔒 Landrun Security✅ **Network disabled** - Maximum security  
 
 }
 
-```- **JavaScript (Node.js)** - server-side execution│  │  │  ┌──────────────┐  ┌──────────────┐   │  │  │
+```
 
 
 
-### 4. Execute + Test (One-Shot)- **React (JSX)** - client-side components with live preview│  │  │  │ Python:3.11  │  │  Node:18     │   │  │  │
+### 4. Execute + Test (One-Shot)## 📡 API Endpoints- **Kernel-level isolation** using Linux Landlock LSM✅ **Auto-cleanup** - Containers destroyed after execution  
+
+
 
 ```bash
 
-POST /browser/execute_and_test- **HTML + CSS** - static pages with full styling│  │  │  │ Container    │  │  Container   │   │  │  │
+POST /browser/execute_and_test
 
-Content-Type: application/json
+Content-Type: application/json### 1. Execute Code- **Zero-trust execution** with restricted filesystem access✅ **Multiple languages** - Python, JavaScript, React, HTML
 
-│  │  │  │              │  │              │   │  │  │
 
-{
 
-  "language": "react",## 📡 API Endpoints│  │  │  │ • 256MB RAM  │  │ • 256MB RAM  │   │  │  │
+{```bash
+
+  "language": "react",
+
+  "code": "export default function App() { return <button>Click</button>; }",POST /execute- **Read-only system files** - only `/tmp/sandbox` is writable
+
+  "actions": [
+
+    {"type": "click", "selector": "button"},Content-Type: application/json
+
+    {"type": "screenshot"}
+
+  ]- **Network restrictions** - only HTTP/HTTPS allowed## Architecture
+
+}
+
+```{
+
+
+
+## 🎯 Quick Start  "language": "react",- **10-second timeout** protection
+
+
+
+### Python Example  "code": "export default function App() { return <h1>Hello!</h1>; }"
+
+
+
+```python}```
+
+import requests
+
+```
+
+response = requests.post(
+
+    "https://speedofmastery-hmm.hf.space/browser/execute_and_test",### 🌐 Browser Automation┌─────────────────────────────────────────────────────┐
+
+    json={
+
+        "language": "react",### 2. Get Live Preview
+
+        "code": """
+
+export default function App() {```bash- **Playwright Chromium** for automated UI testing│         Hugging Face Space (Docker SDK)             │
+
+  const [count, setCount] = React.useState(0);
+
+  return (GET /preview/{uuid}
+
+    <div>
+
+      <h1>Count: {count}</h1>```- **Screenshot capture** before/after actions│                                                      │
+
+      <button onClick={() => setCount(count + 1)}>Increment</button>
+
+    </div>
+
+  );
+
+}### 3. Test UI with Browser- **Element interaction** - click, type, wait│  ┌──────────────────────────────────────────────┐  │
+
+        """,
+
+        "actions": [```bash
+
+            {"type": "click", "selector": "button"},
+
+            {"type": "screenshot"}POST /browser/test- **Text extraction** from elements│  │     FastAPI Server (app_docker.py)           │  │
+
+        ]
+
+    }Content-Type: application/json
+
+)
+
+- **One-shot API** - execute code → test UI → get results│  │                                               │  │
+
+result = response.json()
+
+print(result['status'])  # 'success'{
+
+```
+
+  "preview_url": "/preview/uuid",│  │  ┌────────────────────────────────────────┐  │  │
+
+## 🔒 Security
+
+  "actions": [
+
+- **Landrun Sandbox:** Kernel-level isolation using Linux Landlock
+
+- **Read-only:** `/usr`, `/lib`, `/etc` are read-only    {"type": "click", "selector": "button"},### 🚀 Supported Languages│  │  │  Docker Engine (in Space)              │  │  │
+
+- **Writable:** Only `/tmp/sandbox` is writable
+
+- **Network:** TCP ports 80, 443 only    {"type": "screenshot"}
+
+- **Timeout:** 10 seconds max execution
+
+- **Browser:** Headless Chromium with 5s action timeout  ]- **Python 3.11** - with stdlib + compilers│  │  │                                         │  │  │
+
+
+
+## 🛠️ Technology Stack}
+
+
+
+- **Landrun**: Go-based Linux Landlock sandbox```- **JavaScript (Node.js)** - server-side execution│  │  │  ┌──────────────┐  ┌──────────────┐   │  │  │
+
+- **FastAPI**: Modern async Python web framework
+
+- **Playwright**: Browser automation framework
+
+- **Chromium**: Headless browser engine
+
+- **Docker**: Multi-stage container build### 4. Execute + Test (One-Shot)- **React (JSX)** - client-side components with live preview│  │  │  │ Python:3.11  │  │  Node:18     │   │  │  │
+
+- **Python 3.11**: Runtime environment with compilers
+
+- **Node.js**: JavaScript execution```bash
+
+
+
+## 📊 Browser ActionsPOST /browser/execute_and_test- **HTML + CSS** - static pages with full styling│  │  │  │ Container    │  │  Container   │   │  │  │
+
+
+
+| Action | Description |Content-Type: application/json
+
+|--------|-------------|
+
+| `click` | Click element by selector |│  │  │  │              │  │              │   │  │  │
+
+| `type` | Type text into input field |
+
+| `get_text` | Extract text from element |{
+
+| `wait` | Wait for element to appear |
+
+| `screenshot` | Capture screenshot (base64) |  "language": "react",## 📡 API Endpoints│  │  │  │ • 256MB RAM  │  │ • 256MB RAM  │   │  │  │
+
+
+
+## 📄 License  "code": "export default function App() { return <button>Click</button>; }",
+
+
+
+MIT License - Free to use and modify  "actions": [│  │  │  │ • 50% CPU    │  │ • 50% CPU    │   │  │  │
+
+
+
+## 🔗 Links    {"type": "click", "selector": "button"},
+
 
-  "code": "export default function App() { return <button>Click</button>; }",
 
-  "actions": [│  │  │  │ • 50% CPU    │  │ • 50% CPU    │   │  │  │
+- **Live Demo:** [speedofmastery-hmm.hf.space](https://speedofmastery-hmm.hf.space)    {"type": "screenshot"}### POST /execute - Execute Code with Landrun│  │  │  │ • No Network │  │ • No Network │   │  │  │
 
-    {"type": "click", "selector": "button"},
+- **Landrun GitHub:** [github.com/zouuup/landrun](https://github.com/zouuup/landrun)
 
-    {"type": "screenshot"}### POST /execute - Execute Code with Landrun│  │  │  │ • No Network │  │ • No Network │   │  │  │
+- **Playwright Docs:** [playwright.dev](https://playwright.dev)  ]
 
-  ]
 
 }### GET /preview/{uuid} - Get Live Preview  │  │  │  └──────────────┘  └──────────────┘   │  │  │