Browser-Use WebUI が ImportError になる件

概要

Browser-Use WebUI を Windows 環境で実行しようとした際に、次のエラーが発生する件についてのメモです。問題は報告されているっぽいので近く修正が入るかもしれませんが、早く試したかったので暫定対処をしてみました。

エラー文:

ImportError: cannot import name 'AgentStepErrorTelemetryEvent' from 'browser_use.telemetry.views'

発生背景

この問題は、Browser-Use WebUI のリポジトリのソースコード内で使用されているモジュール、browser_use.telemetry.views が最新バージョンのインターフェースと一致していないことが原因です。

暫定対処

下記の通り、browser-use パッケージの指定したバージョンを再インストールすることで暫定的に対処しました。

実施したコマンド:

uv pip install browser-use==0.1.18

暫定対処の手順

必要な前提条件

• Python 3.11以上（私は 3.12.8 を利用）
• uv
• Windows 11（でしか試してません）

手順

1. リポジトリのクローン／ダウンロード
   フォルダを作成し、リポジトリのクローン／ダウンロードします。

   git clone https://github.com/browser-use/web-ui.git . 
   

2. 仮想環境の作成

   uv venv --python 3.12
   

   .venv\Scripts\activate 
   

3. 必要なパッケージのインストール

   uv pip install browser-use==0.1.18
   

   playwright install
   

   uv pip install -r requirements.txt
   

4. 環境変数の設定

   .env ファイルを作成し、必要なAPIキーやブラウザパスを設定します。

5. 起動

   python webui.py --ip 127.0.0.1 --port 7788
   

   ブラウザから http://127.0.0.1:7788 へアクセスし、ツールが起動することを確認します。

おわりに

Browser-Use WebUI の試用中に発生した問題は、パッケージのバージョンコンフリクトで解決することができました。誰かの参考になれば幸いです。

https://github.com/browser-use/web-ui/issues/102