Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
add lightweight CLI install script
ShawnPanad8aeaa9ab4af
diff --git a/browser_use/skill_cli/install_lite.sh b/browser_use/skill_cli/install_lite.shnew file mode 100755index 000000000..d8d9a85bd--- /dev/null+++ b/browser_use/skill_cli/install_lite.sh@@ -0,0 +1,503 @@+#!/usr/bin/env bash+# Browser-Use Lightweight CLI Installer+#+# Installs only the minimal dependencies needed for the CLI (~10 packages+# instead of ~50). Use this if you only need the browser-use CLI commands+# and don't need the Python library (Agent, LLM integrations, etc.).+#+# Usage:+# curl -fsSL <url>/install_lite.sh | bash+#+# For development testing:+# curl -fsSL <raw-url> | BROWSER_USE_BRANCH=<branch-name> bash+#+# To install the full library instead, use install.sh.+#+# =============================================================================++set -e++# =============================================================================+# Configuration+# =============================================================================++# Colors for output+RED='\033[0;31m'+GREEN='\033[0;32m'+YELLOW='\033[1;33m'+BLUE='\033[0;34m'+BOLD='\033[1m'+NC='\033[0m' # No Color++# =============================================================================+# Logging functions+# =============================================================================++log_info() {+ echo -e "${BLUE}ℹ${NC} $1"+}++log_success() {+ echo -e "${GREEN}✓${NC} $1"+}++log_warn() {+ echo -e "${YELLOW}⚠${NC} $1"+}++log_error() {+ echo -e "${RED}✗${NC} $1"+}++# =============================================================================+# Argument parsing+# =============================================================================++parse_args() {+ while [[ $# -gt 0 ]]; do+ case $1 in+ --help|-h)+ echo "Browser-Use Lightweight CLI Installer"+ echo ""+ echo "Usage: install_lite.sh [OPTIONS]"+ echo ""+ echo "Options:"+ echo " --help, -h Show this help"+ echo ""+ echo "Installs Python 3.11+ (if needed), uv, browser-use CLI (minimal deps), and Chromium."+ exit 0+ ;;+ *)+ log_warn "Unknown argument: $1 (ignored)"+ shift+ ;;+ esac+ done+}++# =============================================================================+# Platform detection+# =============================================================================++detect_platform() {+ local os=$(uname -s | tr '[:upper:]' '[:lower:]')+ local arch=$(uname -m)++ case "$os" in+ linux*)+ PLATFORM="linux"+ ;;+ darwin*)+ PLATFORM="macos"+ ;;+ msys*|mingw*|cygwin*)+ PLATFORM="windows"+ ;;+ *)+ log_error "Unsupported OS: $os"+ exit 1+ ;;+ esac++ log_info "Detected platform: $PLATFORM ($arch)"+}++# =============================================================================+# Virtual environment helpers+# =============================================================================++# Get the correct venv bin directory (Scripts on Windows, bin on Unix)+get_venv_bin_dir() {+ if [ "$PLATFORM" = "windows" ]; then+ echo "$HOME/.browser-use-env/Scripts"+ else+ echo "$HOME/.browser-use-env/bin"+ fi+}++# Activate the virtual environment (handles Windows vs Unix paths)+activate_venv() {+ local venv_bin=$(get_venv_bin_dir)+ if [ -f "$venv_bin/activate" ]; then+ source "$venv_bin/activate"+ else+ log_error "Virtual environment not found at $venv_bin"+ exit 1+ fi+}++# =============================================================================+# Python management+# =============================================================================++check_python() {+ log_info "Checking Python installation..."++ # Check versioned python commands first (python3.13, python3.12, python3.11)+ # This handles Ubuntu/Debian where python3 may point to older version+ # Also check common install locations directly in case PATH isn't updated+ local py_candidates="python3.13 python3.12 python3.11 python3 python"+ local py_paths="/usr/bin/python3.11 /usr/local/bin/python3.11"++ for py_cmd in $py_candidates; do+ if command -v "$py_cmd" &> /dev/null; then+ local version=$($py_cmd --version 2>&1 | awk '{print $2}')+ local major=$(echo $version | cut -d. -f1)+ local minor=$(echo $version | cut -d. -f2)++ if [ "$major" -ge 3 ] && [ "$minor" -ge 11 ]; then+ PYTHON_CMD="$py_cmd"+ log_success "Python $version found ($py_cmd)"+ return 0+ fi+ fi+ done++ # Also check common paths directly (in case command -v doesn't find them)+ for py_path in $py_paths; do+ if [ -x "$py_path" ]; then+ local version=$($py_path --version 2>&1 | awk '{print $2}')+ local major=$(echo $version | cut -d. -f1)+ local minor=$(echo $version | cut -d. -f2)++ if [ "$major" -ge 3 ] && [ "$minor" -ge 11 ]; then+ PYTHON_CMD="$py_path"+ log_success "Python $version found ($py_path)"+ return 0+ fi+ fi+ done++ # No suitable Python found+ if command -v python3 &> /dev/null; then+ local version=$(python3 --version 2>&1 | awk '{print $2}')+ log_warn "Python $version found, but 3.11+ required"+ else+ log_warn "Python not found"+ fi+ return 1+}++install_python() {+ log_info "Installing Python 3.11+..."++ # Use sudo only if not root and sudo is available+ SUDO=""+ if [ "$(id -u)" -ne 0 ] && command -v sudo &> /dev/null; then+ SUDO="sudo"+ fi++ case "$PLATFORM" in+ macos)+ if command -v brew &> /dev/null; then+ brew install [email protected]+ else+ log_error "Homebrew not found. Install from: https://brew.sh"+ exit 1+ fi+ ;;+ linux)+ if command -v apt-get &> /dev/null; then+ $SUDO apt-get update+ $SUDO apt-get install -y python3.11 python3.11-venv python3-pip+ elif command -v yum &> /dev/null; then+ $SUDO yum install -y python311 python311-pip+ else+ log_error "Unsupported package manager. Install Python 3.11+ manually."+ exit 1+ fi+ ;;+ windows)+ log_error "Please install Python 3.11+ from: https://www.python.org/downloads/"+ exit 1+ ;;+ esac++ # Verify installation+ if check_python; then+ log_success "Python installed successfully"+ else+ log_error "Python installation failed"+ exit 1+ fi+}++# =============================================================================+# uv package manager+# =============================================================================++install_uv() {+ log_info "Installing uv package manager..."++ # Add common uv install locations to PATH for current session+ # (covers both curl-based and Homebrew installs)+ export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"++ if command -v uv &> /dev/null; then+ log_success "uv already installed"+ return 0+ fi++ # Use official uv installer+ curl -LsSf https://astral.sh/uv/install.sh | sh++ if command -v uv &> /dev/null; then+ log_success "uv installed successfully"+ else+ log_error "uv installation failed. Try restarting your shell and run the installer again."+ exit 1+ fi+}++# =============================================================================+# Browser-Use installation (lightweight - CLI deps only)+# =============================================================================++install_browser_use() {+ log_info "Installing browser-use (lightweight CLI)..."++ # Create or use existing virtual environment+ if [ ! -d "$HOME/.browser-use-env" ]; then+ # Use discovered Python command (e.g., python3.11) or fall back to version spec+ if [ -n "$PYTHON_CMD" ]; then+ uv venv "$HOME/.browser-use-env" --python "$PYTHON_CMD"+ else+ uv venv "$HOME/.browser-use-env" --python 3.11+ fi+ fi++ # Activate venv and install+ activate_venv++ # Install from GitHub (main branch by default, or custom branch for testing)+ BROWSER_USE_BRANCH="${BROWSER_USE_BRANCH:-main}"+ BROWSER_USE_REPO="${BROWSER_USE_REPO:-browser-use/browser-use}"+ log_info "Installing from GitHub: $BROWSER_USE_REPO@$BROWSER_USE_BRANCH"+ # Clone and install the package without its declared dependencies,+ # then install only the minimal deps the CLI actually needs at runtime.+ # This avoids pulling ~50 packages (LLM clients, PDF tools, etc.) that+ # the CLI never imports.+ local tmp_dir=$(mktemp -d)+ git clone --depth 1 --branch "$BROWSER_USE_BRANCH" "https://github.com/$BROWSER_USE_REPO.git" "$tmp_dir"+ uv pip install "$tmp_dir" --no-deps+ rm -rf "$tmp_dir"++ # Install only the dependencies the CLI actually needs (~10 packages).+ # Transitive deps (e.g. websockets via cdp-use) are resolved automatically.+ log_info "Installing minimal CLI dependencies..."+ uv pip install \+ "bubus==1.5.6" \+ "cdp-use==1.4.5" \+ "httpx==0.28.1" \+ "psutil==7.2.2" \+ "pydantic==2.12.5" \+ "pydantic-settings==2.12.0" \+ "python-dotenv==1.2.1" \+ "typing-extensions==4.15.0" \+ "uuid7==0.1.0"++ log_success "browser-use CLI installed (lightweight)"+}++install_chromium() {+ log_info "Installing Chromium browser..."++ activate_venv++ # Build command - only use --with-deps on Linux (it fails on Windows/macOS)+ local cmd="uvx playwright install chromium"+ if [ "$PLATFORM" = "linux" ]; then+ cmd="$cmd --with-deps"+ fi+ cmd="$cmd --no-shell"++ eval $cmd++ log_success "Chromium installed"+}++install_profile_use() {+ log_info "Installing profile-use..."++ mkdir -p "$HOME/.browser-use/bin"+ curl -fsSL https://browser-use.com/profile/cli/install.sh | PROFILE_USE_VERSION=v1.0.2 INSTALL_DIR="$HOME/.browser-use/bin" sh++ if [ -x "$HOME/.browser-use/bin/profile-use" ]; then+ log_success "profile-use installed"+ else+ log_warn "profile-use installation failed (will auto-download on first use)"+ fi+}++# =============================================================================+# PATH configuration+# =============================================================================++configure_path() {+ local shell_rc=""+ local bin_path=$(get_venv_bin_dir)+ local local_bin="$HOME/.local/bin"++ # Detect shell+ if [ -n "$BASH_VERSION" ]; then+ shell_rc="$HOME/.bashrc"+ elif [ -n "$ZSH_VERSION" ]; then+ shell_rc="$HOME/.zshrc"+ else+ shell_rc="$HOME/.profile"+ fi++ # Check if already in PATH (browser-use-env matches both /bin and /Scripts)+ if grep -q "browser-use-env" "$shell_rc" 2>/dev/null; then+ log_info "PATH already configured in $shell_rc"+ else+ # Add to shell config (includes ~/.local/bin for tools)+ echo "" >> "$shell_rc"+ echo "# Browser-Use" >> "$shell_rc"+ echo "export PATH=\"$bin_path:$local_bin:\$PATH\"" >> "$shell_rc"+ log_success "Added to PATH in $shell_rc"+ fi++ # On Windows, also configure PowerShell profile+ if [ "$PLATFORM" = "windows" ]; then+ configure_powershell_path+ fi+}++configure_powershell_path() {+ # Use PowerShell to modify user PATH in registry (no execution policy needed)+ # This persists across sessions without requiring profile script execution++ local scripts_path='\\.browser-use-env\\Scripts'+ local local_bin='\\.local\\bin'++ # Check if already in user PATH+ local current_path=$(powershell.exe -Command "[Environment]::GetEnvironmentVariable('Path', 'User')" 2>/dev/null | tr -d '\r')++ if echo "$current_path" | grep -q "browser-use-env"; then+ log_info "PATH already configured"+ return 0+ fi++ # Append to user PATH via registry (safe, no truncation, no execution policy needed)+ powershell.exe -Command "[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + \$env:USERPROFILE + '$scripts_path;' + \$env:USERPROFILE + '$local_bin', 'User')" 2>/dev/null++ if [ $? -eq 0 ]; then+ log_success "Added to Windows PATH: %USERPROFILE%\\.browser-use-env\\Scripts"+ else+ log_warn "Could not update PATH automatically. Add manually:"+ log_warn " \$env:PATH += \";\$env:USERPROFILE\\.browser-use-env\\Scripts\""+ fi+}++# =============================================================================+# Validation+# =============================================================================++validate() {+ log_info "Validating installation..."++ activate_venv++ if browser-use doctor; then+ log_success "Installation validated successfully!"+ return 0+ else+ log_warn "Some checks failed. Run 'browser-use doctor' for details."+ return 1+ fi+}++# =============================================================================+# Print completion message+# =============================================================================++print_next_steps() {+ # Detect shell for source command+ local shell_rc=".bashrc"+ if [ -n "$ZSH_VERSION" ]; then+ shell_rc=".zshrc"+ fi++ echo ""+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"+ echo ""+ log_success "Browser-Use CLI installed successfully! (lightweight)"+ echo ""++ echo "Next steps:"+ if [ "$PLATFORM" = "windows" ]; then+ echo " 1. Restart PowerShell (PATH is now configured automatically)"+ else+ echo " 1. Restart your shell or run: source ~/$shell_rc"+ fi+ echo " 2. Try: browser-use open https://example.com"+ echo ""+ echo "To install the full library (Agent, LLMs, etc.):"+ echo " uv pip install browser-use"++ echo ""+ echo "Documentation: https://docs.browser-use.com"+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"+ echo ""+}++# =============================================================================+# Main installation flow+# =============================================================================++main() {+ echo ""+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"+ echo " Browser-Use Lightweight CLI Installer"+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"+ echo ""++ # Parse command-line flags+ parse_args "$@"++ # Step 1: Detect platform+ detect_platform++ # Step 2: Check/install Python+ if ! check_python; then+ # In CI or non-interactive mode (no tty), auto-install Python+ if [ ! -t 0 ]; then+ log_info "Python 3.11+ not found. Installing automatically..."+ install_python+ else+ read -p "Python 3.11+ not found. Install now? [y/N] " -n 1 -r < /dev/tty+ echo+ if [[ $REPLY =~ ^[Yy]$ ]]; then+ install_python+ else+ log_error "Python 3.11+ required. Exiting."+ exit 1+ fi+ fi+ fi++ # Step 3: Install uv+ install_uv++ # Step 4: Install browser-use package (minimal deps only)+ install_browser_use++ # Step 5: Install Chromium+ install_chromium++ # Step 6: Install profile-use+ install_profile_use++ # Step 7: Configure PATH+ configure_path++ # Step 8: Validate+ validate++ # Step 9: Print next steps+ print_next_steps+}++# Run main function with all arguments+main "$@"