Update README.md

README.md

@@ -9,4 +9,26 @@ app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🛰️ 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.