브라우저 사용 웹 UI: 웹 탐색을 위해 AI 인텔리전스를 실행하기 위한 오픈 소스 프레임워크로, AI가 웹 페이지를 자동으로 조작할 수 있습니다.

일반 소개

브라우저 사용 웹 UI는 AI 에이전트에게 브라우저 상호작용 기능을 위한 그래픽 인터페이스 도구를 제공하는 데 중점을 둔 혁신적인 오픈 소스 프로젝트입니다. 이 프로젝트는 브라우저 사용 핵심 프레임워크 위에 Gradio를 통해 사용자 친화적인 웹 인터페이스가 구축되어 AI 에이전트가 브라우저와 편리하게 상호 작용할 수 있습니다. 이 프로젝트는 Gemini, OpenAI, Azure OpenAI, Anthropic, DeepSeek, Ollama를 비롯한 다양한 주류 LLM(대규모 언어 모델)을 지원합니다. 특히 주목할 만한 점은 이 도구가 자체 브라우저를 사용하는 사용자를 지원하여 중복 로그인 및 인증과 같은 일반적인 문제를 해결한다는 점입니다. 2025년 1월 현재, 이 프로젝트는 GitHub에서 2,601개의 별 태그를 받았으며 332개의 브랜치를 보유하고 있어 강력한 커뮤니티의 존재감을 보여주고 있습니다.

기능 목록

• 여러 대규모 언어 모델 통합 지원(Gemini, OpenAI, Azure OpenAI 등)
• 개별 브라우저 구성을 통한 사용자 지정 브라우저 지원
• AI 작업 간 브라우저 상태 유지를 지원하는 브라우저 세션 지속성
• Docker 컨테이너화된 배포 옵션 제공
• VNC 원격 보기 브라우저 작동 프로세스 지원
• 멀티 테마 인터페이스 지원(바다, 소프트, 모노크롬, 유리 등)
• 밝은 모드와 어두운 모드 간 전환 지원
• 실시간 브라우저 상호작용 시각화
• 유연한 환경 변수 구성 지원

도움말 사용

1. 환경 준비

• Python 환경 요구 사항: 3.11 이상
• Python 환경 설정에 권장되는 UV 도구 사용 방법

2. 설치 방식

로컬 설치:

1. 가상 환경을 만듭니다:

uv venv --python 3.11
source .venv/bin/activate

1. 종속성을 설치합니다:

bash

uv pip install -r requirements.txt
playwright install

도커 설치:

1. 복제 창고:

bash

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

1. 환경을 구성합니다:

• .env.example를 .env에 복사합니다.
• 필요한 API 키와 환경 변수를 구성하세요.

1. 서비스를 시작합니다:

bash

docker compose up --build

3. 핵심 기능 사용에 대한 안내

WebUI 시작:

bash

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

개인 브라우저 구성:

1. Windows 시스템 구성 예제:

환경

CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
CHROME_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"

1. Mac 시스템 구성 예시:

환경

CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
CHROME_USER_DATA="~/Library/Application Support/Google/Chrome/Profile 1"

브라우저 세션 관리:

• 임시 세션 모드: 각 AI 작업이 완료된 후 브라우저를 닫습니다.
• 영구 세션 모드: 영구 세션 모드를 설정하는 방법은CHROME_PERSISTENT_SESSION=true사용 시작

Docker 환경을 위한 고급 기능:

• VNC 원격 보기: 액세스http://localhost:6080/vnc.html
• 해상도 사용자 지정: 환경 변수를 통한RESOLUTION설정
• 보안 액세스: 사용자 지정 가능한 VNC 비밀번호

4. 문제 해결 팁:

• 맞춤 브라우저를 사용할 때는 모든 Chrome 창을 닫아야 합니다.
• WebUI 액세스에는 Chrome 이외의 브라우저(예: Firefox 또는 Edge)를 사용하는 것이 좋습니다.
• Docker를 배포할 때 로그를 확인해야 합니다:docker compose logs -f