README.md

---
title: Browser Gradio
emoji: ⚡
colorFrom: pink
colorTo: green
sdk: gradio
sdk_version: 5.34.2
app_file: app.py
pinned: false
---

# 🛰️ Real Browser Demo (with Playwright)

This is an interactive web browser simulation that uses a **real headless browser (Firefox via Playwright)** on the server to access the live internet.

It demonstrates how to combine the power of a modern web automation tool like Playwright with the simplicity of a Gradio UI.

## How it Works

1.  **Enter a URL** (e.g., `https://news.ycombinator.com`) or a **search term** (e.g., `latest science news`) into the address bar and click "Go".
2.  On the server, **Playwright launches a real, headless Firefox browser** and navigates to the requested page. It waits for the page and its JavaScript to fully load.
3.  The complete, rendered HTML is then parsed using **BeautifulSoup**.
4.  The **page title, main text content, and a list of clickable links** are extracted.
5.  This extracted information is sent back and displayed in the Gradio UI.
6.  You can **"click" links** by entering their corresponding number and clicking the "Click Link" button.
7.  All standard browser functions like **tabs, back/forward, and refresh** are supported and operate on the real browser instance.

### Why Playwright?

-   **JavaScript Rendering:** It can correctly display modern Single-Page Applications (SPAs) that `requests` would fail on.
-   **Robustness:** It behaves like a real user, making it much less likely to be blocked by websites.
-   **Stateful Interaction:** It naturally handles cookies, sessions, and complex navigation.

**Note:** Since this demo is making live web requests, it may be slower than the "pseudo browser" and is subject to the speed and availability of the websites you visit.