leeykike/browser-use

   HF_TOKEN=hf_xxx          # HF Token（需要 write 权限，用于读写配置到 Dataset 仓库）
   ACCESS_PASSWORD=xxx       # 访问密码（保护所有 API 和 Web UI）
   CONFIG_PASSWORD=xxx       # 配置管理密码（保护 LLM 配置的增删改操作）

# 克隆代码
git clone https://huggingface.co/spaces/your-username/your-space
cd your-space

# 构建并运行
docker build -t browser-use-api .
docker run -d -p 7860:7860 \
  -e ACCESS_PASSWORD=your-password \
  browser-use-api

# 访问
open http://localhost:7860

# 安装依赖
pip install -r requirements.txt
playwright install chromium --with-deps

# 运行服务
python app.py

curl -X POST https://your-space.hf.space/task \
  -H "Content-Type: application/json" \
  -H "X-Access-Password: your-password" \
  -d '{
    "task": "访问百度，搜索今天的天气",
    "headless": true,
    "save_screenshots": true,
    "compress_screenshots": true,
    "use_vision": false,
    "llm_config": {
      "provider": "deepseek",
      "model": "deepseek-chat",
      "api_key": "sk-xxx"
    }
  }'

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "任务已提交"
}

curl -H "X-Access-Password: your-password" \
  https://your-space.hf.space/task/{task_id}

{
  "task_id": "550e8400-...",
  "status": "completed",
  "result": "今天北京天气晴，温度15-25度",
  "steps": [...],
  "screenshots": ["550e8400_1_120001", "550e8400_2_120005"]
}

# 获取最新截图
curl -H "X-Access-Password: your-password" \
  https://your-space.hf.space/task/{task_id}/screenshot/latest -o latest.png

# 获取指定截图
curl -H "X-Access-Password: your-password" \
  https://your-space.hf.space/screenshot/{screenshot_id} -o screenshot.png

curl -X POST https://your-space.hf.space/task \
  -H "Content-Type: application/json" \
  -H "X-Access-Password: your-password" \
  -d '{
    "task": "搜索新闻",
    "llm_config": {...},
    "webhook": {
      "url": "https://your-server.com/webhook",
      "secret": "your-secret-key",
      "events": ["task.started", "task.completed"]
    }
  }'

{
  "provider": "deepseek",
  "model": "deepseek-chat",
  "api_key": "sk-xxx"
}

{
  "provider": "ollama",
  "model": "qwen2.5:14b",
  "base_url": "http://localhost:11434"
}

{
  "provider": "siliconflow",
  "model": "Pro/deepseek-ai/DeepSeek-V3",
  "api_key": "sk-xxx"
}

{
  "provider": "custom",
  "model": "DeepSeek-R1",
  "api_key": "sk-xxx",
  "base_url": "https://llmapi.blsc.cn/v1"
}

import requests
import time

BASE_URL = "https://your-space.hf.space"
PASSWORD = "your-password"
HEADERS = {"X-Access-Password": PASSWORD}

# 1. 创建任务
response = requests.post(
    f"{BASE_URL}/task",
    headers=HEADERS,
    json={
        "task": "访问百度，搜索今天的天气",
        "llm_config": {
            "provider": "deepseek",
            "model": "deepseek-chat",
            "api_key": "sk-xxx"
        }
    }
)
task_id = response.json()["task_id"]
print(f"任务已创建: {task_id}")

# 2. 轮询等待完成
while True:
    result = requests.get(f"{BASE_URL}/task/{task_id}", headers=HEADERS).json()
    status = result["status"]
    print(f"状态: {status}")
    
    if status in ["completed", "failed", "cancelled"]:
        break
    time.sleep(3)

# 3. 获取结果
if status == "completed":
    print(f"结果: {result['result']}")
    
    # 下载截图
    for i, screenshot_id in enumerate(result["screenshots"]):
        img = requests.get(f"{BASE_URL}/screenshot/{screenshot_id}", headers=HEADERS)
        with open(f"screenshot_{i+1}.png", "wb") as f:
            f.write(img.content)

const BASE_URL = 'https://your-space.hf.space';
const PASSWORD = 'your-password';
const headers = { 'X-Access-Password': PASSWORD };

// 创建任务
const response = await fetch(`${BASE_URL}/task`, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    task: '访问百度，搜索今天的天气',
    llm_config: {
      provider: 'deepseek',
      model: 'deepseek-chat',
      api_key: 'sk-xxx'
    }
  })
});

const { task_id } = await response.json();
console.log(`任务已创建: ${task_id}`);

// 轮询等待完成
let result;
while (true) {
  const res = await fetch(`${BASE_URL}/task/${task_id}`, { headers });
  result = await res.json();
  
  if (['completed', 'failed', 'cancelled'].includes(result.status)) {
    break;
  }
  
  await new Promise(resolve => setTimeout(resolve, 3000));
}

console.log(`结果: ${result.result}`);

# 获取 Token: https://huggingface.co/settings/tokens

curl -H "Authorization: Bearer hf_xxx" \
  https://your-space.hf.space/health

MAX_CONCURRENT_TASKS=2
MAX_BROWSER_POOL_SIZE=2
TASK_TIMEOUT=300
BROWSER_IDLE_TIMEOUT=60

// 建立 WebSocket 连接
const ws = new WebSocket('wss://your-space.hf.space/task/{task_id}/screen/stream?password=xxx');

ws.onmessage = function(event) {
  const data = JSON.parse(event.data);
  
  if (data.event === 'frame') {
    // data.data 是 base64 编码的 JPEG 图片（已压缩优化）
    document.getElementById('screen').src = 'data:image/jpeg;base64,' + data.data;
  } else if (data.event === 'waiting') {
    // 等待浏览器启动...
  } else if (data.event === 'task_ended') {
    // 任务已结束
  }
};

// 建立 SSE 连接
const eventSource = new EventSource('/task/{task_id}/logs/stream?password=xxx');

eventSource.onmessage = function(event) {
  const log = JSON.parse(event.data);
  console.log(`[${log.type}] Step ${log.step}: ${log.content}`);
};

eventSource.onerror = function() {
  eventSource.close();
};