README.md

---
title: Cloud Browser Service
emoji: 🌐
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 8000
pinned: false
---

# Cloud Browser Service

Dịch vụ này cho phép bạn chạy trình duyệt web từ xa thông qua API, sử dụng GoLogin và Orbita Browser.

## Thiết lập cho Hugging Face Spaces

1. Sao chép repository này vào Hugging Face Space của bạn
2. Đặt biến môi trường `GOLOGIN_TOKEN` trong cài đặt Space của bạn
3. Khởi động Space

## API Endpoints

### `POST /browser/start`
Khởi động một trình duyệt mới và trả về profile ID và WebSocket URL.

### `POST /browser/navigate`
Điều hướng trình duyệt đến URL xác định và trả về ảnh chụp màn hình.
Body: `{ "profileId": "...", "url": "https://example.com" }`

### `POST /browser/stop`
Đóng trình duyệt.
Body: `{ "profileId": "..." }`

## Sử dụng Local

Để chạy locally, sử dụng file Dockerfile.huggingface:

```bash
# Build image
docker build -f Dockerfile.huggingface -t cloudbrowser .

# Chạy container
docker run -p 8080:8080 -p 3000:3000 -e GOLOGIN_TOKEN=your_token_here cloudbrowser
```

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference