Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

add lightweight CLI install script

ShawnPanaa2cbe678b7e5
diff --git a/browser_use/skill_cli/install_lite.sh b/browser_use/skill_cli/install_lite.sh
new file mode 100755
index 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 "$@"