browser-use 0.x üzerine bir sistem kurduysanız, 1.0 sürümü hem mimariyi hem de varsayılan ayarları değiştiriyor. 24 ayrı tarayıcı eylemi yerine kalıcı tek bir Python REPL geliyor; Browser() ise artık bulut tarayıcı anlamına geliyor. Bu rehberde 1.0.7 sürümünü sabitlemeyi, ilk çalıştırmayı ve 0.x geçişini; 1.0.7 sürüm notları, MIGRATING.md ve 20 Kasım tarihli mühendislik yazısı temelinde ele alıyoruz.
1.0'ı 5 dakikada çalıştırın
Önce sürümü sabitleyin. 1.0.0, 10 Kasım 2026'da yayımlandı; 20 Kasım itibarıyla kararlı etiket 1.0.7'ydi ve 1.0.8rc1 ön sürüm durumundaydı (sürümler). README, küçük sürümler arasında API'lerin bozulabildiğini belirterek >= kullanmamanızı açıkça söylüyor.
uv add 'browser-use==1.0.7'
# or
pip install 'browser-use==1.0.7'Gereksinimler net: Python 3.11 veya daha yeni bir sürüm ve 4.0'dan eski olmalı (README, PyPI). Tüm bağımlılıklar == ile sabitlenmiş. Bu, tekrarlanabilir kurulum açısından avantajlı olsa da uygulamanız farklı bir pydantic, mcp veya google-genai sürümüne ihtiyaç duyuyorsa çakışma çıkarabilir.
Kimlik doğrulamayı bir kez yapmanız yeterli. cloud.browser-use.com üzerinden bir anahtar oluşturun, ardından anahtarı dışa aktarın veya giriş yardımcısını çalıştırın:
export BROWSER_USE_API_KEY=bu_...
# or
browser-use loginGiriş bilgileri ~/.config/browser-harness/auth.json dosyasına kaydedilir ve CLI, MCP sunucusu ile browser-harness tarafından ortak kullanılır (MIGRATING.md). Container ortamlarında BROWSER_USE_AUTO_LOGIN=true kullanın. SSH veya başsız makinelerde 1.0.8 sürüm adayı, başka bir cihazdan onaylayabileceğiniz bir bağlantı ve onay kodu gösteriyor (1.0.8rc1 notları).
İlk çalıştırma için üç satır yeterli:
from browser_use import Agent
result = Agent(
"Find the number of stars of the browser-use repo"
).run_sync()
print(result.final_result())Ancak bu örnek varsayılan olarak ücretli bir çalıştırmadır: Browser Use Cloud tarayıcısını ve varsayılan ağ geçidi modelini kullanır (README Path 1 / Path 3, MIGRATING.md varsayılanları). Bu testi bulut maliyeti olmadan yapmak istiyorsanız, daha baştan Browser('chromium') ve kendi llm modelinizi ekleyin.
24 eylemin yerini ne aldı?
browser-use 0.x, modele bir menü sunuyordu: DOM çıktısından her adım için tek bir eylem seçiliyordu. 1.0 bu menüyü tamamen kaldırıyor. Model artık Pydantic AI üzerine kurulu, browser-harness yardımcıları ve ham cdp() önceden içe aktarılmış kalıcı bir REPL olan tek bir ana python aracını kullanıyor (mühendislik yazısı):
async def python(ctx: RunContext[Session], code: str) -> list[Any]:
"""Run Python in the persistent REPL
(browser-harness helpers and raw cdp() pre-imported)."""Bu sadeleştirme 554 dosyada 136.905 satırı kaldırırken 29.601 satır ekledi; Python dosyalarının sayısı da 178'den 43'e indi (mühendislik yazısı).
En iyi örnek, takılan bir sayfanın kurtarılması. Ajan Page.stopLoading çağırdı, kilitlenen betiği durdurdu, sayfayı yeniden yükledi, sayfanın gizli JSONP uç noktasını buldu; ardından 730 tarihi gruplar halinde çekip yalnızca başarısız grupları yeniden denedi. Üstelik bunların hiçbiri için özel bir araca ihtiyaç duymadı ve 4.720 satır döndürdü (mühendislik yazısı).
Ekibin koruduğu temel kural şu: Model, bir yardımcının kodunu bir kez okuduktan sonra onu yeniden yazamıyorsa yardımcı oluşturun. CAPTCHA bunun istisnası. Küçük bir staging testinde düz metin talimatları hCaptcha'da 0/3 sonuç verirken özel solve_captcha aracı 6/6 yaptı; çünkü bu araç, sayfanın erişemediği bir çözücü anahtarını etkinleştiriyor (mühendislik yazısı).
Maliyet ve hız konusunda başlığa bakıp dipnotu atlamayın. 20 Kasım tarihli yazı, 8 Kasım'da gerçekleştirilen ve 180 görevin puanlandığı 200 görevlik çalışmada aynı üç modelin 1.0 sürümünde 0.x'e göre 14–33 puan daha yüksek skor aldığını ve maliyetin 2,7–5,2 kat daha düşük olduğunu bildiriyor. Ancak testin model başına tek çalıştırmadan oluştuğu ve varsayılanların değiştiği özellikle belirtiliyor; dolayısıyla tüm kazanımı araç tasarımına bağlamak doğru değil (mühendislik yazısı).
Daha sağlıklı karşılaştırmalar daha dar kapsamlı. 1.0.4, 1.0.3'teki 76,0 puana karşı 76,1 puan aldı. Toplu ekran görüntüsü ayıklama, istem önbelleklemesini koruduğu için model maliyeti görev başına 0,434 dolardan 0,208 dolara düştü (1.0.4 notları). BU Bench v2'de 1.0 ultrafast; Browser Use Pi'nin 56,3 puan, 0,082 dolar ve 743 saniyelik sonuçlarına karşı 62,5 puan, 0,070 dolar ve 650 saniye aldı. Yazarlar, sağlayıcı hataları çıkarıldığında farkın anlamlılığını kaybettiğini söylüyor. Beklentiyi daha ucuz ve daha hızlı olacak şekilde kurun; otomatik olarak daha akıllı olacağını varsaymayın.
Faturanızı ve tarayıcınızı sessizce değiştiren varsayılanlar
Bu tablo MIGRATING.md ve 1.0.6 sürüm notlarından derlendi; 1.0.7'yi ve eski rehberlerin çoğunda yer almayan, 1.0 serisinin ortasında yapılan varsayılan model değişikliğini yansıtıyor.
| Ayar | 0.x | 1.0.7 |
|---|---|---|
llm=None | Model belirtilmesi gerekiyordu | Browser Use ağ geçidi üzerinden bu-4.0 |
bu-4.0 fiyatı | yok | 1 milyon girdi için 1,80 $, 1 milyon çıktı için 9,00 $ |
bu-fast fiyatı | yok | 1 milyon girdi için 0,12 $, 1 milyon çıktı için 0,60 $ |
Browser() | Yerel Chromium | Browser Use Cloud tarayıcısı |
| Yerel tarayıcı | Varsayılan | Açıkça Browser('chromium') |
| API anahtarı | Sağlayıcı başına bir tane | Tek bir BROWSER_USE_API_KEY |
max_steps | 500 | 100 (teslim için bir adım ayrılıyor) |
| Ajan zaman aşımı | Belirtilmemiş | Başlatma ve kapatma hariç 1.700 saniye |
| Değerlendirici | İsteğe bağlı | Varsayılan olarak judge=True |
| Akıl yürütme / mod | yok | bu-fast / bu-ultrafast üzerinde reasoning='medium', mode='ultrafast' |
Özellikle üç tuzağa dikkat edin. İlki, varsayılan modelin 1.0 serisinin ortasında değişmiş olması. 1.0.5'e kadar olan sürümlerde varsayılan bu-fast iken 1.0.6 ile bu değer, token fiyatı 15 kat daha yüksek olan bu-4.0'a çevrildi. Projenin kendi örneğinde aynı kısa test bu-4.0 ile 0,022 $, bu-fast ile 0,0014 $ tutuyor. Eski maliyet profilini istiyorsanız llm='bu-fast' değerini açıkça geçin. İkincisi, boş bir Browser() artık saat başına 0,06 $ ücretli bulut tarayıcısı açıyor; buna model ve arama başına ücretler de ekleniyor (README). Bulut tarayıcıları localhost'a veya özel IP'lere erişemiyor (MIGRATING.md). Üçüncüsü, bir adım bir model isteği ve bir Python hücresi anlamına geliyor. Bu nedenle 100 adımlık düşük sınır aynı zamanda harcama sınırı görevi görüyor; max_steps < 1 veya timeout <= 0 değerleri artık tarayıcı başlamadan önce hata veriyor (MIGRATING.md).
Değerlendirici de gizli maliyet kalemlerinden biri. En az bir adım içeren her çalıştırmanın ardından kendi modeliniz, 120.000 karaktere kadar iz verisi ve görsel kullanımında son sayfa dahil birbirinden farklı son dört görsel üzerinden bir ek, düşük eforlu istek yapıyor. Bu veriler sansürlenmeden gönderiliyor (MIGRATING.md). Sonuçlar result.judgement içinde success, failure_reason, gotchas ve bot/CAPTCHA işaretleriyle yer alıyor; maliyet de result.cost_usd değerine ekleniyor. judge=False ile özelliği kapatabilir veya beklenen yanıtı içeren judge_context gönderebilirsiniz. Ekran görüntüleri sınırınızın dışına hiç çıkmamalıysa use_vision=False ayarını kullanın.
Gerekiyorsa yerelde kalın
Tarayıcı seçimini alışkanlığa göre değil, erişilecek ağa göre yapın. Aşağıdaki model tanımlayıcısı, README'deki yerel tarayıcı örneğinde kullanılan temsili sağlayıcı örneğidir (README):
from browser_use import Agent, Browser, ChatOpenAI
agent = Agent(
"Summarize the dashboard at http://localhost:3000",
llm=ChatOpenAI("gpt-6-luna"),
browser=Browser("chromium"),
)
print(agent.run_sync().final_result())localhost, özel ağlar, özel viewport değerleri veya bulut cihaz ölçümü çağrılarının gerçek sayfa viewport'unu değiştirmeyeceği durumlarda Browser('chromium') kullanın. Mevcut oturumlarınızla açık Chrome'u kontrol etmek için Browser('chrome') tercih edebilirsiniz. Browser('chrome', profile='Work') oturum bilgilerini içeren geçici bir kopya açar, ancak Sync değişiklikleri geri yazmaz. Windows'ta çerezleri kilitlediği için önce orijinal Chrome'u kapatın (MIGRATING.md). Yönetilen gizlilik, proxy, CAPTCHA çözümü veya sıfır yerel kurulum gerekiyorsa bulut hâlâ doğru varsayılan seçimdir (README). Yalnızca tarayıcı saatlerini token maliyetlerinden ayrı bütçelemeyi unutmayın.
Özel modeller hâlâ kullanılabiliyor; ancak yöntemi doğru seçmeniz gerekiyor (MIGRATING.md):
- Ağ geçidi takma adları:
bu-4.0,bu-4.0-mini,bu-4.0-pro,bu-fast,bu-ultrafast,bu-smart - Sağlayıcılar:
ChatOpenAI,ChatAnthropic,ChatGoogleveyagroq:llama-3.3-70b-versatilegibi Pydantic AI dizeleri - Azure için
AZURE_OPENAI_ENDPOINT,AZURE_OPENAI_API_KEYveOPENAI_API_VERSIONilellm='azure:<deployment>'
LangChain sohbet nesnelerini Agent(llm=...) olarak vermek artık TypeError oluşturuyor. bu-2-0 gibi kullanımdan kaldırılmış ağ geçidi adları da tarayıcı başlamadan reddediliyor. Her paralel ajan kendi Browser() nesnesine sahip olmalı; iki ajanın aynı tarayıcıyı paylaşması RuntimeError doğuruyor. Buna karşılık keep_alive=True ile açılan tek bir tarayıcı sıralı çalıştırmalarda yeniden kullanılabiliyor (MIGRATING.md).
Tahmin yürütmeden geçiş yapın: Hata ne söylüyorsa onu izleyin
1.0, bilerek hızlı hata veriyor. Kaldırılan içe aktarmalar yerine geçen seçeneği belirten ImportError üretirken, desteklenmeyen Agent(...) bağımsız değişkenleri TypeError oluşturuyor. 1.0'ın karşılayamadığı her şey, tarayıcı başlamadan ve ücret yazılmadan önce hata veriyor (MIGRATING.md). use_vision=True, vision_detail_level, max_actions_per_step, flash_mode, max_failures, highlight_elements ve benzeri bazı ayarların kabul edilmesine rağmen yok sayıldığına dair her biri için tek bir uyarı gösteriliyor. use_vision=False ise hâlâ anlamlı; ekran görüntülerinin modele gönderilmesini engelliyor.
Başlatma sonrasında davranış değişiyor: run() genellikle hata yükseltmek yerine status='error' ve result.error ayrıntıları içeren bir hata sonucu döndürüyor. Yalnızca iptal işlemi dışarı taşmaya devam ediyor. Kontrollerinizi buna göre güncelleyin:
# 0.x
history = await agent.run(max_steps=500)
ok = history.is_successful()
# 1.0
result = await agent.run(max_steps=100)
ok = result.is_done() and result.success is not Falseis_done() artık yalnızca çalıştırmanın tamamlandığını ifade ediyor. Başarı, modelin finish(result, success) kararıyla belirleniyor; model herhangi bir karar vermediyse is_successful() None döndürüyor. Eski adım bazlı geçmiş yardımcıları (action_names(), model_actions(), extracted_content(), save_as_playwright_script() ve MIGRATING.md içindeki kaldırılan geçmiş API'leri listesinde yer alan diğerleri) artık yok. Bunun yerine result.messages, result.status, result.partial, agent.workspace içindeki dosyalar ve result.judgement okunmalı.
İşe şu üç değişiklikle başlayın: max_steps değerini Agent(...) içinden çıkarıp agent.run(max_steps=...) çağrısına taşıyın; kaldırılan callback'lerin (on_step_start, pause, stop, multi_act, save_history) yerine INFO seviyesinde logging.getLogger('browser_use') veya BROWSER_USE_LOGGING_LEVEL=warning kullanın; sırları yeniden kapsamlandırın. Alan kapsamlı sırlar artık yalnızca eşleşen sayfalarda yazılıyor. Adı bu_2fa_code ile biten değerler TOTP tohumu kabul ediliyor. Eski <secret>name</secret> yer tutucusu hata veriyor ve type_secret('name') biçimine dönüştürülmesi gerekiyor. Değerler hücrelerde ve sonuçlarda <secret:name> olarak maskeleniyor; ancak bu bir sandbox değil, çünkü model tarafından yazılan Python bunları yine de okuyabilir (MIGRATING.md). Zamana ihtiyacınız varsa pip install 'browser-use<1' ile sürümü sabitleyip geçişi ayrı bir dalda yapın.
"browser use is more a python framework for building your own browsing agent" — r/ClaudeCode üzerinde u/Starks1293
Bu tanım, Reddit tartışmalarındaki kullanıcı yorumlarıyla da örtüşüyor: browser-use, özellikle bot korumalı siteler ve kod seviyesinde kontrol için anılan, tarama ajanları oluşturmaya yönelik bir framework olarak görülüyor. Güvenilirlik ise modele ve siteye bağlı kalmaya devam ediyor. Bir üretim raporunda, basit form doldurma işinde beş dakika ve dokuz başarısız adım gerektiği anlatılıyor.
Üretim öncesi: değerlendirici, sırlar ve değişken başarı oranı
İleri seviye kullanımda önemli noktalar şunlar:
output_model_schemaile tip güvenli sonuçlar; bu sonuçlarresult.structured_outputüzerinden okunuyor- Workspace yüklemeleri ve
workspace/downloads; indirilen dosyalarresult.downloadsiçinde - Alan kontrolleri (
allowed_domains,prohibited_domains,block_ip_addresses); bunlar uyumlu çalışan bir modeli sınırlar, ağı sandbox'a almaz - İsteğe bağlı
web_search=True; her arama için ücretresult.cost_usddeğerine eklenir browser-use --cli-mcp,browser-use skill installvebrowser-use --doctorüzerinden CLI/MCP
1.0'ı hızlı değişen bir framework olarak değerlendirin: tam sürümleri sabitleyin, uzun görevlerde judge_context ekleyin, kısmi çalışmayı checkpoint('titles.json', titles, partial=True) ile kaydedin ve güvenilmeyen görevleri container'larda çalıştırın. Çünkü alan sınırlamaları ve sır maskeleme izolasyon sağlamaz (README).
Şimdi mi geçmeli, sürümü mü sabitlemeli, yoksa 0.x'te mi kalmalı?
| Durum | Yapılacak |
|---|---|
| Yeni ajan projesi, bulut kullanımı sorun değil | ==1.0.7 ile başlayın, bu-4.0 varsayılanını koruyun ve değerlendiriciyi açık bırakın |
| Maliyete duyarlı toplu işler | llm='bu-fast' ve judge=False kullanın; ölçeklemeden önce ölçüm yapın |
| Localhost / intranet / özel viewport | Kendi modelinizle Browser('chromium') kullanın; boş Browser() kullanmayın |
| Üretimde çalışan mevcut 0.x sistemi | Ana dalda browser-use<1 sürümünü sabitleyin, hızlı hata veren mesajları kullanarak geçişi ayrı dalda yapın |
| CAPTCHA ağırlıklı akış | Özel çözücü için bütçe ayırın; ekibin testinde yalnızca metin talimatları 0/3 sonuç verdi |
Takılan bir betiği durdurabilen veya daha önce sarmalamadığınız özel bir API'yi çağırabilen bir ajan kazanıyorsunuz; karşılığında sabit eylem menüsünün güvenlik sınırlarını kaybediyorsunuz. Bu değiş tokuş siteniz için uygunsa geçiş yapın. Değilse, mevcut üretim sistemlerini değerlendirirken browser-use<1 ile sürümü sabit tutmak daha güvenli seçenek olmaya devam ediyor.
Sık sorulan sorular
browser-use 1.0'da ne değişti?
0.x'teki 24 eylemden oluşan menünün yerini browser-harness yardımcıları ve ham CDP içeren kalıcı bir Python REPL aldı; kütüphanenin yaklaşık %80'i kaldırıldı ve Python dosyalarının sayısı 178'den 43'e indi. Varsayılanlar da Browser Use Cloud'a, bir ağ geçidi modeline ve tek bir BROWSER_USE_API_KEY değerine geçti.
0.x kodum bozulur mu?
Yaygın giriş noktaları (Agent, Browser, run(), final_result()) hâlâ mevcut. Ancak kaldırılan içe aktarmalar ve seçenekler ücretlendirme başlamadan önce ImportError veya TypeError oluşturuyor; max_steps run() çağrısına taşındı ve Browser() artık bulut anlamına geliyor. Sistemi olduğu gibi korumak için browser-use<1 sürümünü sabitleyin veya önce ayrı bir dalda geçiş yapın.
Kendi modelimi ve yerel tarayıcıyı kullanabilir miyim?
Evet. ChatOpenAI, ChatAnthropic, ChatGoogle gibi sağlayıcıları veya bir Pydantic AI dizesini geçebilir; yeni bir yerel tarayıcı için Browser('chromium'), açık Chrome'unuz için Browser('chrome') kullanabilirsiniz. Bulut tarayıcıları localhost'a erişemez.
browser-use 1.0 hangi Python sürümünü gerektiriyor?
Python 3.11 veya daha yeni bir sürüm ve 4.0'dan eski olmalı. Bağımlılıkların tam sürümle sabitlenmesi diğer paketlerle çakışabileceğinden önce yeni bir sanal ortamda kurulum yapın.
Çalıştırma değerlendiricisini nasıl kapatırım?
Ek değerlendirme isteğini atlamak için judge=False geçin. Kararın işe yarar olması için kabul kriterlerinizi içeren judge_context kullanabilirsiniz. Değerlendiriciye ekran görüntüsü gönderilmemesi gerekiyorsa use_vision=False ayarını etkinleştirin.