Auto-commit: README.md updated

README.md

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