README.md

---
title: minimal-helium-experiment
emoji: 💻
colorFrom: blue
colorTo: red
sdk: docker
app_file: app/server.py
pinned: false
---

# Minimal Browser Screenshot Experiment with Helium

This web application allows taking screenshots of websites using a headless browser and displaying them directly in the user interface.

## Features

- Simple and responsive web interface
- URL input with default value pointing to Open LLM Leaderboard
- Screenshot capture via Helium (Chrome browser)
- Display of results in the interface

## Technologies Used

- **Backend**: FastAPI, Helium
- **Frontend**: HTML/JS with Tailwind CSS
- **Dependency Management**: Poetry
- **Deployment**: Docker, Hugging Face Spaces

## Local Installation

### Prerequisites

- Python 3.10+
- Poetry
- Docker (optional)

### Installation with Poetry

```bash
# Clone the repository
git clone [repo-url]
cd minimal-browser-screenshot-experiment

# Install dependencies
poetry install

# Launch the application
poetry run uvicorn app.server:app --host 0.0.0.0 --port 7860
```

### Using Docker

```bash
# Build the Docker image
docker build -t minimal-browser-screenshot .

# Run the container
docker run -p 7860:7860 minimal-browser-screenshot
```

## Deployment on Hugging Face Spaces

This application is designed to be easily deployed on a Hugging Face Space.

1. Create a new Docker-type Space
2. Associate this GitHub repository with your Space
3. The Space will automatically use the provided Dockerfile to build and deploy the application

## Usage

1. Access the application through your browser
2. Enter the URL of the site you want to screenshot (default: Open LLM Leaderboard)
3. Click "Take a screenshot"
4. Wait a few seconds for the headless browser to load the page and take the screenshot
5. The screenshot appears in the interface

## About Helium

Helium is a Python library that simplifies browser automation. It's an abstraction layer on top of Selenium that offers a simpler and more intuitive API. Helium was chosen to replace Playwright in this project to demonstrate its ease of use.