Auto-commit: README.md updated

README.md

@@ -1,775 +1,91 @@
-------------
-
+---
 title: Landrun Sandbox + Browser Automation
-
-emoji: 🔒title: Landrun Sandbox + Browser Automation
-
+emoji: 🔒
 colorFrom: purple
-
-colorTo: blueemoji: 🔒title: Landrun Sandbox + Browser Automationtitle: Docker Sandbox
-
+colorTo: blue
 sdk: docker
-
-app_file: app.pycolorFrom: purple
-
+app_file: app.py
 pinned: false
-
-license: mitcolorTo: blueemoji: 🔒🌐emoji: 🐳
-
+license: mit
 ---
 
-sdk: docker
-
-# 🔒 Landrun Sandbox + Browser Automation
-
-app_file: app.pycolorFrom: purplecolorFrom: blue
+# Landrun Sandbox + Browser Automation
 
 **Kernel-Level Code Execution Sandbox with Automated UI Testing**
 
-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
-
-sdk: dockersdk: docker
-
-- **Kernel-level isolation** using Linux Landlock LSM
-
-- **Zero-trust execution** with restricted filesystem access# 🔒 Landrun Sandbox + Browser Automation
-
-- **Read-only system files** - only `/tmp/sandbox` is writable
-
-- **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.
-
-- **Element interaction** - click, type, wait, get text
-
-- **One-shot API** - execute code → test UI → get results------
-
-
-
-### 🚀 Supported Languages## ✨ Features
-
-
-
-- **Python 3.11** - with stdlib + compilers (gcc, g++)
-
-- **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
-
-- **Zero-trust execution** with restricted filesystem access
-
-### 1. Execute Code
-
-- **Read-only system files** - only `/tmp/sandbox` is writable
-
-```bash
-
-POST /execute- **Network restrictions** - only HTTP/HTTPS allowed
-
-Content-Type: application/json
-
-- **10-second timeout** protection**Kernel-Level Code Execution Sandbox + Automated UI Testing****Secure code execution in isolated Docker containers**
-
-{
-
-  "language": "react",
-
-  "code": "export default function App() { return <h1>Hello!</h1>; }"
-
-}### 🌐 Browser Automation
-
-```
-
-- **Playwright Chromium** for automated UI testing
-
-### 2. Get Live Preview
-
-- **Screenshot capture** before/after actionsExecute code with maximum security using **Landrun** (Linux Landlock kernel security) and automatically test UIs with **Playwright** browser automation.## Features
-
-```bash
-
-GET /preview/{uuid}- **Element interaction** - click, type, wait, get text
-
-```
-
-- **One-shot API** - execute code → test UI → get results
-
-### 3. Test UI with Browser
-
-
-
-```bash
-
-POST /browser/test### 🚀 Supported Languages## ✨ Features✅ **Isolated execution** - Each code run in separate container  
-
-Content-Type: application/json
-
-- **Python 3.11** - with stdlib + compilers (gcc, g++)
-
-{
-
-  "preview_url": "/preview/uuid",- **JavaScript (Node.js)** - server-side execution✅ **Resource limits** - 256MB RAM, 50% CPU per execution  
-
-  "actions": [
-
-    {"type": "click", "selector": "button"},- **React (JSX)** - client-side components with live preview
-
-    {"type": "screenshot"}
-
-  ]- **HTML + CSS** - static pages with full styling### 🔒 Landrun Security✅ **Network disabled** - Maximum security  
-
-}
-
-```
-
-
-
-### 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
-
-Content-Type: application/json### 1. Execute Code- **Zero-trust execution** with restricted filesystem access✅ **Multiple languages** - Python, JavaScript, React, HTML
-
-
-
-{```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}
+## Features
 
+### Landrun Security
+- Kernel-level isolation using Linux Landlock LSM
+- Zero-trust execution with restricted filesystem access
+- Read-only system files - only /tmp/sandbox is writable
+- Network restrictions - only HTTP/HTTPS allowed
+- 10-second timeout protection
 
-
-- **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"},
-
-
-
-- **Live Demo:** [speedofmastery-hmm.hf.space](https://speedofmastery-hmm.hf.space)    {"type": "screenshot"}### POST /execute - Execute Code with Landrun│  │  │  │ • No Network │  │ • No Network │   │  │  │
-
-- **Landrun GitHub:** [github.com/zouuup/landrun](https://github.com/zouuup/landrun)
-
-- **Playwright Docs:** [playwright.dev](https://playwright.dev)  ]
-
-
-}### 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>
-
-    </div>## 📄 License- Containers are **destroyed after execution**
-
-  );
-
-}- **No persistent storage** between executions
-
-        """,
-
-        "actions": [MIT License
-
-            {"type": "click", "selector": "button"},
-
-            {"type": "screenshot"}### 🚫 Resource Limits
-
-        ]- **Memory**: 256MB per container
-
-    }- **CPU**: 50% of one core
-
-)- **Timeout**: 30 seconds default
-
-- **Network**: Disabled (network_mode="none")
-
-result = response.json()
-
-print(result['status'])  # 'success'### 🔒 Security Constraints
-
-```- **No root access** in containers
-
-- **No file system persistence**
-
-## 🔒 Security- **No network access**
-
-- **Automatic cleanup** after execution
-
-- **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
-
-- **Timeout:** 10 seconds max execution
-
-- **Browser:** Headless Chromium with 5s action timeout#### 1. SDK
-
-```yaml
-
-## 🛠️ Technology Stacksdk: docker
-
-```
-
-- **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
-
-```txt
-
-| 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
-
-```bash
-
-MIT License - Free to use and modify# Create new space with Docker SDK
-
-# Name: your-docker-sandbox
-
-## 🔗 Links# SDK: Docker
-
-```
-
-- **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
-```
-
-Or manually:
-```bash
-# Clone your space
-git clone https://huggingface.co/spaces/YOUR_USERNAME/your-docker-sandbox
-cd your-docker-sandbox
-
-# Copy files
-cp Dockerfile.sandbox Dockerfile
-cp app_docker.py app.py
-cp requirements.txt .
-
-# Add README
-cp README_DOCKER.md README.md
-
-# Commit and push
-git add .
-git commit -m "Deploy Docker sandbox"
-git push
-```
-
-### Step 3: Enable Docker in Space Settings
-1. Go to Space Settings
-2. Under "Advanced", enable **"Docker SDK"**
-3. Set **"Timeout"** to 60+ seconds
-4. Save settings
-
-## API Usage
-
-### Endpoint
-```
-POST https://YOUR_USERNAME-your-docker-sandbox.hf.space/execute
-```
-
-### Request Format
-```json
-{
-  "language": "python",
-  "code": "print('Hello from Docker!')",
-  "timeout": 30
-}
-```
+### Browser Automation
+- Playwright Chromium for automated UI testing
+- Screenshot capture before/after actions
+- Element interaction - click, type, wait, get text
+- One-shot API - execute code and test UI in single call
 
 ### Supported Languages
-- `python` - Python 3.11 in Alpine container
-- `javascript` - Node.js 18 in Alpine container
-- `react` - Client-side React (no container needed)
-- `html` - Pure HTML (no container needed)
-
-### Response Format
-```json
-{
-  "status": "success",
-  "preview_url": "data:text/html;base64,...",
-  "terminal_view_url": "data:text/html;base64,...",
-  "execution_time": 0.234,
-  "docker_enabled": true
-}
-```
-
-## Example: Python Code Execution
-
-### PowerShell
-```powershell
-$apiUrl = "https://YOUR_USERNAME-your-docker-sandbox.hf.space/execute"
-
-$code = @"
-import sys
-print(f'Python {sys.version}')
-print('Running in Docker container!')
-for i in range(5):
-    print(f'Count: {i}')
-"@
-
-$body = @{
-    language = "python"
-    code = $code
-    timeout = 30
-} | ConvertTo-Json
-
-$response = Invoke-RestMethod -Uri $apiUrl -Method Post -Body $body -ContentType "application/json"
-
-# Display terminal output
-$terminalHtml = "<html><body><iframe src='$($response.terminal_view_url)' style='width:100%;height:100vh;border:none;'></iframe></body></html>"
-$terminalHtml | Out-File -FilePath "docker_terminal.html"
-Start-Process "docker_terminal.html"
-```
-
-### JavaScript (Node.js)
-```javascript
-const apiUrl = "https://YOUR_USERNAME-your-docker-sandbox.hf.space/execute";
+- Python 3.11 with stdlib + compilers
+- JavaScript Node.js server-side execution
+- React JSX client-side components with live preview
+- HTML + CSS static pages with full styling
 
-const code = `
-console.log('Node.js in Docker!');
-console.log('Environment:', process.version);
-const data = [1, 2, 3, 4, 5];
-console.log('Sum:', data.reduce((a, b) => a + b, 0));
-`;
+## API Endpoints
 
-fetch(apiUrl, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-        language: 'javascript',
-        code: code,
-        timeout: 30
-    })
-})
-.then(res => res.json())
-.then(data => {
-    console.log('Execution time:', data.execution_time);
-    // Open terminal view
-    const iframe = document.createElement('iframe');
-    iframe.src = data.terminal_view_url;
-    iframe.style = 'width:100%;height:100vh;border:none;';
-    document.body.appendChild(iframe);
-});
-```
+### POST /execute
+Execute code in sandbox and get preview URL
 
-### React Example
-```javascript
-const reactCode = `
-const { useState } = React;
+### GET /preview/{uuid}
+Get live HTML preview of executed code
 
-function Counter() {
-  const [count, setCount] = useState(0);
-  
-  return (
-    <div style={{ padding: '40px', textAlign: 'center', fontFamily: 'Arial' }}>
-      <h1 style={{ fontSize: '48px', color: '#667eea' }}>Counter: {count}</h1>
-      <button 
-        onClick={() => setCount(count + 1)}
-        style={{ 
-          padding: '15px 30px', 
-          fontSize: '20px', 
-          background: '#667eea', 
-          color: 'white', 
-          border: 'none', 
-          borderRadius: '10px',
-          cursor: 'pointer',
-          margin: '10px'
-        }}
-      >
-        Increment
-      </button>
-      <button 
-        onClick={() => setCount(count - 1)}
-        style={{ 
-          padding: '15px 30px', 
-          fontSize: '20px', 
-          background: '#764ba2', 
-          color: 'white', 
-          border: 'none', 
-          borderRadius: '10px',
-          cursor: 'pointer',
-          margin: '10px'
-        }}
-      >
-        Decrement
-      </button>
-    </div>
-  );
-}
+### POST /browser/test
+Test existing preview with browser automation
 
-ReactDOM.render(<Counter />, document.getElementById('root'));
-`;
+### POST /browser/execute_and_test
+Execute code and test UI in single call (one-shot)
 
-fetch(apiUrl, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-        language: 'react',
-        code: reactCode
-    })
-})
-.then(res => res.json())
-.then(data => {
-    // React runs client-side, so preview_url contains the full app
-    window.open(data.preview_url, '_blank');
-});
-```
+## Quick Start
 
-## Advantages of Docker Sandbox
+Python example:
+- Execute React code with browser automation
+- Click buttons and capture screenshots
+- Get test results with base64 screenshots
 
-### ✅ vs Regular Hugging Face Spaces
-1. **Complete Isolation** - Each execution is fully isolated
-2. **Resource Control** - Strict memory and CPU limits
-3. **No Contamination** - Containers destroyed after use
-4. **Multiple Runtimes** - Python, Node, Ruby, etc. in separate containers
-5. **Security** - No network, no persistence, no escape
+## Security
 
-### ✅ vs Local Sandboxie
-1. **Cloud-Native** - No local installation needed
-2. **Always Available** - 24/7 API access
-3. **Scalable** - Handles multiple concurrent requests
-4. **Platform Independent** - Works from any device
+- Landrun Sandbox: Kernel-level isolation using Linux Landlock
+- Read-only: /usr, /lib, /etc are read-only
+- Writable: Only /tmp/sandbox is writable
+- Network: TCP ports 80, 443 only
+- Timeout: 10 seconds max execution
+- Browser: Headless Chromium with 5s action timeout
 
-### ✅ vs Process-Based Execution
-1. **Better Isolation** - Container vs process boundaries
-2. **Cleaner Cleanup** - No orphaned processes
-3. **Reproducible** - Same environment every time
-4. **Safer** - Can't access host filesystem
+## Technology Stack
 
-## Monitoring
+- Landrun: Go-based Linux Landlock sandbox
+- FastAPI: Modern async Python web framework
+- Playwright: Browser automation framework
+- Chromium: Headless browser engine
+- Docker: Multi-stage container build
+- Python 3.11: Runtime environment with compilers
+- Node.js: JavaScript execution
 
-### Health Check
-```bash
-curl https://YOUR_USERNAME-your-docker-sandbox.hf.space/health
-```
+## Browser Actions
 
-Response:
-```json
-{
-  "status": "healthy",
-  "docker_available": true
-}
-```
-
-### Container Stats
-The Docker executor automatically:
-- Removes containers after execution
-- Logs container lifecycle events
-- Tracks resource usage
-- Enforces timeouts
-
-## Troubleshooting
-
-### "Docker not available"
-**Solution**: Ensure Space is using Docker SDK:
-1. Space Settings → SDK → Select "Docker"
-2. Wait for rebuild
-3. Check `/health` endpoint
-
-### Execution Timeout
-**Solution**: Increase timeout in request:
-```json
-{
-  "language": "python",
-  "code": "...",
-  "timeout": 60
-}
-```
-
-### Container Memory Error
-**Solution**: Optimize code or contact HF support for higher limits
-
-### Network Errors in Container
-**Expected**: Containers have `network_mode="none"` for security
-- React/HTML work because they run **client-side**
-- Python/JavaScript run **server-side** without network
-
-## Performance
-
-### Typical Execution Times
-- **Python simple**: ~0.5-1s (container startup + execution)
-- **JavaScript simple**: ~0.6-1.2s
-- **React**: ~0.1s (client-side, no container)
-- **HTML**: ~0.05s (client-side, no container)
-
-### Cold Start
-First execution may take 2-5 seconds to pull Docker images.
-
-## Best Practices
-
-### 1. Choose Right Language
-- Use **React/HTML** for UI apps (faster, client-side)
-- Use **Python/JavaScript** for computation (secure, isolated)
-
-### 2. Optimize Code
-- Keep execution time under 10 seconds
-- Avoid heavy computations in containers
-- Use React for interactive UIs
-
-### 3. Handle Errors
-```javascript
-try {
-    const response = await fetch(apiUrl, { ... });
-    const data = await response.json();
-    if (data.status === 'error') {
-        console.error('Execution failed');
-    }
-} catch (error) {
-    console.error('API error:', error);
-}
-```
-
-## Future Enhancements
-
-- [ ] Multi-language containers (Go, Rust, Ruby)
-- [ ] Custom Docker images
-- [ ] Volume mounting for data
-- [ ] WebSocket for real-time output
-- [ ] GPU support for ML workloads
+Available actions: click, type, get_text, wait, screenshot
 
 ## License
-MIT License - Feel free to use and modify!
 
----
+MIT License
+
+## Links
 
-**Questions?** Open an issue or discussion on the Space!
+- Live Demo: https://speedofmastery-hmm.hf.space
+- Landrun GitHub: https://github.com/zouuup/landrun
+- Playwright Docs: https://playwright.dev