veilrender 0.1.0__tar.gz → 0.2.0__tar.gz

{veilrender-0.1.0 → veilrender-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: veilrender
-Version: 0.1.0
+Version: 0.2.0
 Summary: Headless browser rendering API — self-hostable on HF Spaces, Docker, or bare metal
 Author: Peng Ding
 License-Expression: MIT
@@ -23,15 +23,23 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 [![PyPI version](https://img.shields.io/pypi/v/veilrender?color=green)](https://pypi.org/project/veilrender/)
 [![GitHub release](https://img.shields.io/github/v/release/Oaklight/veilrender?color=green)](https://github.com/Oaklight/veilrender/releases/latest)
 [![CI](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml/badge.svg)](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml)
-[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender)](https://hub.docker.com/r/oaklight/veilrender)
-[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender?color=blue)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker&color=blue)](https://hub.docker.com/r/oaklight/veilrender)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![HF Spaces](https://img.shields.io/badge/%F0%9F%A4%97-Spaces-blue)](https://huggingface.co/spaces/oaklight/veilrender)
+[![Live Demo](https://img.shields.io/badge/%F0%9F%A4%97-Live_Demo-blue)](https://oaklight-veilrender-public.hf.space)
 
 [中文](README_zh.md) | **English**
 
 Headless browser rendering API — self-hostable on HF Spaces, Docker, or bare metal.
 
+### Try it now (no auth needed)
+
+```bash
+curl -X POST https://oaklight-veilrender-public.hf.space/render \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
 VeilRender accepts a URL and returns the fully rendered page content (HTML, Markdown, readability-extracted article) using a headless Chromium browser. Designed as a fallback for fetch tools that fail on JavaScript-rendered pages.
 
 ## Quick Start
@@ -39,7 +47,7 @@ VeilRender accepts a URL and returns the fully rendered page content (HTML, Mark
 ### Docker
 
 ```bash
-docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret ghcr.io/oaklight/veilrender
+docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret oaklight/veilrender
 ```
 
 ### Local Development

{veilrender-0.1.0 → veilrender-0.2.0}/README.md

@@ -3,15 +3,23 @@
 [![PyPI version](https://img.shields.io/pypi/v/veilrender?color=green)](https://pypi.org/project/veilrender/)
 [![GitHub release](https://img.shields.io/github/v/release/Oaklight/veilrender?color=green)](https://github.com/Oaklight/veilrender/releases/latest)
 [![CI](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml/badge.svg)](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml)
-[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender)](https://hub.docker.com/r/oaklight/veilrender)
-[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender?color=blue)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker&color=blue)](https://hub.docker.com/r/oaklight/veilrender)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![HF Spaces](https://img.shields.io/badge/%F0%9F%A4%97-Spaces-blue)](https://huggingface.co/spaces/oaklight/veilrender)
+[![Live Demo](https://img.shields.io/badge/%F0%9F%A4%97-Live_Demo-blue)](https://oaklight-veilrender-public.hf.space)
 
 [中文](README_zh.md) | **English**
 
 Headless browser rendering API — self-hostable on HF Spaces, Docker, or bare metal.
 
+### Try it now (no auth needed)
+
+```bash
+curl -X POST https://oaklight-veilrender-public.hf.space/render \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
 VeilRender accepts a URL and returns the fully rendered page content (HTML, Markdown, readability-extracted article) using a headless Chromium browser. Designed as a fallback for fetch tools that fail on JavaScript-rendered pages.
 
 ## Quick Start
@@ -19,7 +27,7 @@ VeilRender accepts a URL and returns the fully rendered page content (HTML, Mark
 ### Docker
 
 ```bash
-docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret ghcr.io/oaklight/veilrender
+docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret oaklight/veilrender
 ```
 
 ### Local Development

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/__init__.py

@@ -1,3 +1,3 @@
 """VeilRender — headless browser rendering API."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/app.py

@@ -11,7 +11,7 @@ from veilrender._vendor.httpserver import App
 from veilrender.browser import browser_manager
 from veilrender.cdp_proxy import handle_cdp_upgrade, is_websocket_upgrade
 from veilrender.config import settings
-from veilrender.routes import health, render, screenshot
+from veilrender.routes import dashboard, health, render, screenshot
 
 logging.basicConfig(
     level=logging.INFO,
@@ -40,6 +40,7 @@ def create_app() -> App:
 
     # Register routes
     health.register(app)
+    dashboard.register(app)
     render.register(app)
     screenshot.register(app)
 

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/browser.py

@@ -139,6 +139,16 @@ class BrowserManager:
             assert self._browser is not None
             return self._browser
 
+    @property
+    def active_pages(self) -> int:
+        """Number of browser pages currently in use."""
+        return settings.max_concurrent - self._semaphore._value
+
+    @property
+    def is_browser_alive(self) -> bool:
+        """Whether the browser process is connected."""
+        return self._browser is not None and self._browser.is_connected()
+
     @asynccontextmanager
     async def get_page(
         self,

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/config.py

@@ -19,7 +19,7 @@ class Settings:
         self.viewport_height: int = int(
             os.environ.get("VEILRENDER_VIEWPORT_HEIGHT", "720")
         )
-        self.max_concurrent: int = int(os.environ.get("VEILRENDER_MAX_CONCURRENT", "3"))
+        self.max_concurrent: int = int(os.environ.get("VEILRENDER_MAX_CONCURRENT", "5"))
 
 
 settings = Settings()

veilrender-0.2.0/src/veilrender/routes/dashboard.py

@@ -0,0 +1,237 @@
+"""Dashboard endpoint — GET / stats page."""
+
+from __future__ import annotations
+
+from veilrender import stats
+from veilrender._vendor.httpserver import App, Request, Response
+from veilrender.browser import browser_manager
+from veilrender.config import settings
+
+_BADGES_HTML = """
+    <a href="https://github.com/Oaklight/veilrender" target="_blank" rel="noopener">
+      <img src="https://img.shields.io/github/stars/Oaklight/veilrender?style=flat&amp;logo=github&amp;label=GitHub" alt="GitHub">
+    </a>
+    <a href="https://pypi.org/project/veilrender/" target="_blank" rel="noopener">
+      <img src="https://img.shields.io/pypi/v/veilrender?style=flat&amp;logo=pypi&amp;logoColor=white&amp;label=PyPI" alt="PyPI">
+    </a>
+    <a href="https://hub.docker.com/r/oaklight/veilrender" target="_blank" rel="noopener">
+      <img src="https://img.shields.io/docker/pulls/oaklight/veilrender?style=flat&amp;logo=docker&amp;logoColor=white&amp;label=Docker" alt="Docker Hub">
+    </a>
+    <a href="https://huggingface.co/spaces/oaklight/veilrender-public" target="_blank" rel="noopener">
+      <img src="https://img.shields.io/badge/%F0%9F%A4%97_HF_Spaces-demo-yellow?style=flat" alt="HF Spaces">
+    </a>
+"""
+
+
+def _stats_row(name: str, ep: stats.EndpointStats) -> str:
+    """Build an HTML table row for one endpoint."""
+    rate_class = (
+        "green"
+        if ep.success_rate >= 95
+        else "yellow"
+        if ep.success_rate >= 80
+        else "red"
+    )
+    return f"""
+        <tr>
+          <td><code>{name}</code></td>
+          <td class="mono">{ep.requests}</td>
+          <td class="mono green">{ep.successes}</td>
+          <td class="mono red">{ep.failures}</td>
+          <td class="mono {rate_class}">{ep.success_rate:.1f}%</td>
+          <td class="mono">{ep.avg_ms:.0f} ms</td>
+          <td class="mono">{ep.p95_ms:.0f} ms</td>
+        </tr>"""
+
+
+def _build_html() -> str:
+    """Build the dashboard HTML."""
+    browser_status = "🟢 alive" if browser_manager.is_browser_alive else "🔴 dead"
+    active = browser_manager.active_pages
+    max_conc = settings.max_concurrent
+
+    total_req = stats.render.requests + stats.screenshot.requests
+    total_ok = stats.render.successes + stats.screenshot.successes
+    total_fail = stats.render.failures + stats.screenshot.failures
+
+    utilization = (active / max_conc * 100) if max_conc > 0 else 0
+    util_class = (
+        "green" if utilization < 70 else "yellow" if utilization < 90 else "red"
+    )
+
+    return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta http-equiv="refresh" content="5">
+  <title>VeilRender Dashboard</title>
+  <style>
+    * {{ margin: 0; padding: 0; box-sizing: border-box; }}
+    body {{
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      background: #0f172a; color: #e2e8f0; padding: 2rem;
+      min-height: 100vh;
+    }}
+
+    /* Header */
+    .header {{
+      display: flex; align-items: center; justify-content: space-between;
+      flex-wrap: wrap; gap: 1rem; margin-bottom: 2rem;
+      padding-bottom: 1.5rem; border-bottom: 1px solid #1e293b;
+    }}
+    .header h1 {{
+      font-size: 1.5rem; font-weight: 700; color: #f8fafc;
+      letter-spacing: -0.02em;
+    }}
+    .header h1 span {{ color: #818cf8; }}
+    .badges {{ display: flex; gap: 0.5rem; flex-wrap: wrap; align-items: center; }}
+    .badges a {{ text-decoration: none; transition: opacity 0.15s; }}
+    .badges a:hover {{ opacity: 0.8; }}
+    .badges img {{ height: 20px; vertical-align: middle; }}
+
+    /* Section labels */
+    .section-label {{
+      font-size: 0.7rem; font-weight: 600; text-transform: uppercase;
+      letter-spacing: 0.08em; color: #64748b; margin-bottom: 0.75rem;
+    }}
+
+    /* Cards */
+    .grid {{
+      display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+      gap: 0.75rem; margin-bottom: 2rem;
+    }}
+    .card {{
+      background: #1e293b; border-radius: 10px; padding: 1.2rem;
+      border: 1px solid #334155; transition: border-color 0.2s;
+    }}
+    .card:hover {{ border-color: #475569; }}
+    .card .label {{
+      font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.06em;
+      color: #94a3b8; margin-bottom: 0.4rem;
+    }}
+    .card .value {{ font-size: 1.6rem; font-weight: 700; font-variant-numeric: tabular-nums; }}
+
+    /* Table */
+    .table-wrap {{
+      background: #1e293b; border-radius: 10px; border: 1px solid #334155;
+      overflow: hidden; margin-bottom: 2rem;
+    }}
+    table {{ width: 100%; border-collapse: collapse; }}
+    th {{
+      padding: 0.7rem 1rem; text-align: left; font-size: 0.7rem;
+      text-transform: uppercase; letter-spacing: 0.06em; color: #94a3b8;
+      background: #1e293b; border-bottom: 1px solid #334155;
+    }}
+    td {{
+      padding: 0.7rem 1rem; border-top: 1px solid rgba(51, 65, 85, 0.5);
+    }}
+    tr:hover td {{ background: rgba(51, 65, 85, 0.3); }}
+    code {{ font-family: "SF Mono", "Fira Code", "Cascadia Code", monospace; font-size: 0.9em; }}
+    .mono {{ font-family: "SF Mono", "Fira Code", "Cascadia Code", monospace; font-variant-numeric: tabular-nums; }}
+
+    /* Colors */
+    .green {{ color: #4ade80; }}
+    .yellow {{ color: #facc15; }}
+    .red {{ color: #f87171; }}
+    .blue {{ color: #60a5fa; }}
+    .indigo {{ color: #818cf8; }}
+
+    /* Capacity bar */
+    .bar-track {{
+      height: 6px; background: #334155; border-radius: 3px;
+      margin-top: 0.5rem; overflow: hidden;
+    }}
+    .bar-fill {{ height: 100%; border-radius: 3px; transition: width 0.3s; }}
+
+    /* Footer */
+    .footer {{
+      font-size: 0.7rem; color: #475569; display: flex;
+      justify-content: space-between; flex-wrap: wrap; gap: 0.5rem;
+    }}
+
+    @media (max-width: 640px) {{
+      body {{ padding: 1rem; }}
+      .header {{ flex-direction: column; align-items: flex-start; }}
+      .grid {{ grid-template-columns: repeat(2, 1fr); }}
+    }}
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>👻 <span>Veil</span>Render</h1>
+    <div class="badges">
+      {_BADGES_HTML}
+    </div>
+  </div>
+
+  <div class="section-label">Overview</div>
+  <div class="grid">
+    <div class="card">
+      <div class="label">Uptime</div>
+      <div class="value">{stats.format_uptime()}</div>
+    </div>
+    <div class="card">
+      <div class="label">Browser</div>
+      <div class="value">{browser_status}</div>
+    </div>
+    <div class="card">
+      <div class="label">Capacity</div>
+      <div class="value {util_class}">{active} <span style="font-size:0.8rem;color:#94a3b8">/ {max_conc}</span></div>
+      <div class="bar-track">
+        <div class="bar-fill" style="width:{utilization:.0f}%;background:{"#4ade80" if utilization < 70 else "#facc15" if utilization < 90 else "#f87171"}"></div>
+      </div>
+    </div>
+    <div class="card">
+      <div class="label">Total Requests</div>
+      <div class="value indigo">{total_req}</div>
+    </div>
+    <div class="card">
+      <div class="label">Successes</div>
+      <div class="value green">{total_ok}</div>
+    </div>
+    <div class="card">
+      <div class="label">Failures</div>
+      <div class="value {"red" if total_fail > 0 else "green"}">{total_fail}</div>
+    </div>
+  </div>
+
+  <div class="section-label">Endpoints</div>
+  <div class="table-wrap">
+    <table>
+      <thead>
+        <tr>
+          <th>Endpoint</th>
+          <th>Requests</th>
+          <th>Success</th>
+          <th>Failure</th>
+          <th>Rate</th>
+          <th>Avg Latency</th>
+          <th>P95 Latency</th>
+        </tr>
+      </thead>
+      <tbody>
+        {_stats_row("/render", stats.render)}
+        {_stats_row("/screenshot", stats.screenshot)}
+      </tbody>
+    </table>
+  </div>
+
+  <div class="footer">
+    <span>Auto-refreshes every 5s &middot; Stats are in-memory, reset on restart</span>
+    <span>VeilRender &middot; Headless browser rendering API</span>
+  </div>
+</body>
+</html>"""
+
+
+def register(app: App) -> None:
+    """Register dashboard route on the app."""
+
+    @app.get("/")
+    async def dashboard(request: Request) -> Response:
+        return Response(
+            body=_build_html(),
+            status_code=200,
+            content_type="text/html; charset=utf-8",
+        )

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/routes/health.py

@@ -11,7 +11,3 @@ def register(app: App) -> None:
     @app.get("/health")
     async def health(request: Request) -> JSONResponse:
         return JSONResponse({"status": "ok"})
-
-    @app.get("/")
-    async def root(request: Request) -> JSONResponse:
-        return JSONResponse({"service": "veilrender", "status": "ok"})

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/routes/render.py

@@ -4,10 +4,12 @@ from __future__ import annotations
 
 import logging
 import re
+import time
 
 from veilrender._vendor.httpserver import App, JSONResponse, Request
 from veilrender._vendor.readability import extract as readability_extract
 from veilrender._vendor.soup import Soup
+from veilrender import stats
 from veilrender.auth import verify_token
 from veilrender.browser import browser_manager
 from veilrender.config import settings
@@ -70,6 +72,8 @@ def register(app: App) -> None:
 
         req = RenderRequest.from_dict(data)
         timeout = req.timeout or settings.timeout
+        stats.render.requests += 1
+        t0 = time.monotonic()
 
         try:
             async with browser_manager.get_page() as (ctx, page):
@@ -83,6 +87,8 @@ def register(app: App) -> None:
                 final_url = page.url
                 html = await page.content()
         except Exception as exc:
+            elapsed = (time.monotonic() - t0) * 1000
+            stats.render.record_failure(elapsed)
             logger.error("Render failed for %s: %s", req.url, exc)
             return JSONResponse(
                 {"error": f"Render failed: {exc!s}"},
@@ -119,4 +125,6 @@ def register(app: App) -> None:
             links=links,
         )
 
+        elapsed = (time.monotonic() - t0) * 1000
+        stats.render.record_success(elapsed)
         return JSONResponse(result.to_dict())

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender/routes/screenshot.py

@@ -3,8 +3,10 @@
 from __future__ import annotations
 
 import logging
+import time
 
 from veilrender._vendor.httpserver import App, Request, Response
+from veilrender import stats
 from veilrender.auth import verify_token
 from veilrender.browser import browser_manager
 from veilrender.config import settings
@@ -38,6 +40,8 @@ def register(app: App) -> None:
 
         req = ScreenshotRequest.from_dict(data)
         timeout = req.timeout or settings.timeout
+        stats.screenshot.requests += 1
+        t0 = time.monotonic()
 
         try:
             async with browser_manager.get_page(
@@ -51,6 +55,8 @@ def register(app: App) -> None:
                 )
                 png_bytes = await page.screenshot(full_page=req.full_page)
         except Exception as exc:
+            elapsed = (time.monotonic() - t0) * 1000
+            stats.screenshot.record_failure(elapsed)
             logger.error("Screenshot failed for %s: %s", req.url, exc)
             return Response(
                 body=f'{{"error": "Screenshot failed: {exc!s}"}}'.encode(),
@@ -58,6 +64,8 @@ def register(app: App) -> None:
                 content_type="application/json",
             )
 
+        elapsed = (time.monotonic() - t0) * 1000
+        stats.screenshot.record_success(elapsed)
         return Response(
             body=png_bytes,
             status_code=200,

veilrender-0.2.0/src/veilrender/stats.py

@@ -0,0 +1,83 @@
+"""In-memory request statistics.
+
+All counters are safe to mutate without locks because asyncio
+is single-threaded cooperative multitasking.
+"""
+
+from __future__ import annotations
+
+import time
+from collections import deque
+from dataclasses import dataclass, field
+
+_start_time: float = time.monotonic()
+
+
+@dataclass
+class EndpointStats:
+    """Per-endpoint request counters and latency tracking."""
+
+    requests: int = 0
+    successes: int = 0
+    failures: int = 0
+    total_ms: float = 0.0
+    _latencies: deque[float] = field(default_factory=lambda: deque(maxlen=1000))
+
+    def record_success(self, elapsed_ms: float) -> None:
+        """Record a successful request."""
+        self.successes += 1
+        self.total_ms += elapsed_ms
+        self._latencies.append(elapsed_ms)
+
+    def record_failure(self, elapsed_ms: float) -> None:
+        """Record a failed request."""
+        self.failures += 1
+        self.total_ms += elapsed_ms
+        self._latencies.append(elapsed_ms)
+
+    @property
+    def avg_ms(self) -> float:
+        """Average latency in milliseconds."""
+        total = self.successes + self.failures
+        return self.total_ms / total if total > 0 else 0.0
+
+    @property
+    def p95_ms(self) -> float:
+        """95th percentile latency in milliseconds."""
+        if not self._latencies:
+            return 0.0
+        sorted_lat = sorted(self._latencies)
+        idx = int(len(sorted_lat) * 0.95)
+        return sorted_lat[min(idx, len(sorted_lat) - 1)]
+
+    @property
+    def success_rate(self) -> float:
+        """Success rate as a percentage."""
+        total = self.successes + self.failures
+        return (self.successes / total * 100) if total > 0 else 0.0
+
+
+render = EndpointStats()
+screenshot = EndpointStats()
+
+
+def uptime_seconds() -> float:
+    """Seconds since the process started."""
+    return time.monotonic() - _start_time
+
+
+def format_uptime() -> str:
+    """Human-readable uptime string."""
+    secs = int(uptime_seconds())
+    days, secs = divmod(secs, 86400)
+    hours, secs = divmod(secs, 3600)
+    mins, secs = divmod(secs, 60)
+    parts = []
+    if days:
+        parts.append(f"{days}d")
+    if hours:
+        parts.append(f"{hours}h")
+    if mins:
+        parts.append(f"{mins}m")
+    parts.append(f"{secs}s")
+    return " ".join(parts)

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: veilrender
-Version: 0.1.0
+Version: 0.2.0
 Summary: Headless browser rendering API — self-hostable on HF Spaces, Docker, or bare metal
 Author: Peng Ding
 License-Expression: MIT
@@ -23,15 +23,23 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 [![PyPI version](https://img.shields.io/pypi/v/veilrender?color=green)](https://pypi.org/project/veilrender/)
 [![GitHub release](https://img.shields.io/github/v/release/Oaklight/veilrender?color=green)](https://github.com/Oaklight/veilrender/releases/latest)
 [![CI](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml/badge.svg)](https://github.com/Oaklight/veilrender/actions/workflows/ci.yml)
-[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender)](https://hub.docker.com/r/oaklight/veilrender)
-[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Pulls](https://img.shields.io/docker/pulls/oaklight/veilrender?color=blue)](https://hub.docker.com/r/oaklight/veilrender)
+[![Docker Image](https://img.shields.io/docker/v/oaklight/veilrender?sort=semver&label=docker&color=blue)](https://hub.docker.com/r/oaklight/veilrender)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![HF Spaces](https://img.shields.io/badge/%F0%9F%A4%97-Spaces-blue)](https://huggingface.co/spaces/oaklight/veilrender)
+[![Live Demo](https://img.shields.io/badge/%F0%9F%A4%97-Live_Demo-blue)](https://oaklight-veilrender-public.hf.space)
 
 [中文](README_zh.md) | **English**
 
 Headless browser rendering API — self-hostable on HF Spaces, Docker, or bare metal.
 
+### Try it now (no auth needed)
+
+```bash
+curl -X POST https://oaklight-veilrender-public.hf.space/render \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
 VeilRender accepts a URL and returns the fully rendered page content (HTML, Markdown, readability-extracted article) using a headless Chromium browser. Designed as a fallback for fetch tools that fail on JavaScript-rendered pages.
 
 ## Quick Start
@@ -39,7 +47,7 @@ VeilRender accepts a URL and returns the fully rendered page content (HTML, Mark
 ### Docker
 
 ```bash
-docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret ghcr.io/oaklight/veilrender
+docker run -p 7860:7860 -e VEILRENDER_API_TOKEN=your-secret oaklight/veilrender
 ```
 
 ### Local Development

{veilrender-0.1.0 → veilrender-0.2.0}/src/veilrender.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/veilrender/browser.py
 src/veilrender/cdp_proxy.py
 src/veilrender/config.py
 src/veilrender/models.py
+src/veilrender/stats.py
 src/veilrender.egg-info/PKG-INFO
 src/veilrender.egg-info/SOURCES.txt
 src/veilrender.egg-info/dependency_links.txt
@@ -29,6 +30,7 @@ src/veilrender/_vendor/structlog.py
 src/veilrender/_vendor/useragent.py
 src/veilrender/_vendor/yaml.py
 src/veilrender/routes/__init__.py
+src/veilrender/routes/dashboard.py
 src/veilrender/routes/health.py
 src/veilrender/routes/render.py
 src/veilrender/routes/screenshot.py