Drop in a screenshot and convert it to clean code (HTML/Tailwind/React/Vue)
Python
import asyncio
from typing import Optional
from playwright.async_api import (
Browser,
Playwright,
TimeoutError as PlaywrightTimeoutError,
async_playwright,
)
from preview_screenshot.base import VIEWPORT_SIZES
PAGE_LOAD_TIMEOUT_MS = 15000
RENDER_SETTLE_MS = 250
class PlaywrightBackend:
"""Default backend: renders in local headless Chromium.
Runs locally, so the page can load assets served from localhost
(e.g. /local-assets/ URLs) that an external screenshot API cannot reach.
Holds one shared browser, launched lazily and reused across captures.
"""
def __init__(self) -> None:
self._playwright: Optional[Playwright] = None
self._browser: Optional[Browser] = None
self._lock = asyncio.Lock()
async def _get_browser(self) -> Browser:
async with self._lock:
if self._browser is None or not self._browser.is_connected():
if self._playwright is None:
self._playwright = await async_playwright().start()
# --no-sandbox: Chromium refuses to launch as root (the user in
# most containers/hosted Linux) unless the sandbox is disabled.
self._browser = await self._playwright.chromium.launch(
headless=True,
args=["--no-sandbox"],
)
return self._browser
async def available(self) -> bool:
"""Launch (and warm up) Chromium; report whether it works.
Catches every failure mode — missing browser binary, missing Linux
system libraries, sandbox errors — and logs why it's disabled.
"""
try:
await self._get_browser()
print("[screenshot_preview] Chromium available — tool enabled.")
return True
except Exception as exc:
print(
"[screenshot_preview] Chromium unavailable — tool disabled. "
f"Install it with `playwright install chromium`. Cause: {exc}"
)
return False
async def capture(
self,
html: str,
device: str = "desktop",
full_page: bool = True,
) -> bytes:
browser = await self._get_browser()
width, height = VIEWPORT_SIZES.get(device, VIEWPORT_SIZES["desktop"])
page = await browser.new_page(
viewport={"width": width, "height": height},
device_scale_factor=1,
)
try:
try:
await page.set_content(
html,
wait_until="networkidle",
timeout=PAGE_LOAD_TIMEOUT_MS,
)
except PlaywrightTimeoutError:
# Content is already set; capture whatever rendered if the
# network never settles (e.g. pages that poll).
pass
try:
await page.evaluate("document.fonts.ready")
except Exception:
pass
await page.wait_for_timeout(RENDER_SETTLE_MS)
return await page.screenshot(full_page=full_page, type="png")
finally:
await page.close()