mirror of
https://github.com/browser-use/browser-use.git
synced 2026-09-14 19:59:47 +08:00
Magnus Müller
b552005356
Production data analysis (BU2, 24h) shows: - 36.5% of consecutive failures are AsyncIO CancelledError in get_browser_state_summary - Complex pages can take 30-60s for DOM extraction alone - 30s timeout was too aggressive for heavy pages 60s provides 2x buffer while still catching genuinely stuck requests. Can be overridden via TIMEOUT_BrowserStateRequestEvent env var. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Codebase Structure
The code structure inspired by https://github.com/Netflix/dispatch.
Very good structure on how to make a scalable codebase is also in this repo.
Just a brief document about how we should structure our backend codebase.
Code Structure
src/
/<service name>/
models.py
services.py
prompts.py
views.py
utils.py
routers.py
/_<subservice name>/
Service.py
Always a single file, except if it becomes too long - more than ~500 lines, split it into _subservices
Views.py
Always split the views into two parts
# All
...
# Requests
...
# Responses
...
If too long → split into multiple files
Prompts.py
Single file; if too long → split into multiple files (one prompt per file or so)
Routers.py
Never split into more than one file