Skip to Content
v3.1.0Installed browsers. Live locators. Verified input.
DocumentationInstallation

Installation

pip install emunium

Requires Python 3.10 or newer. Runtime dependencies per platform:

PlatformInstalled with pip install emuniumNative input through
Windowswebsocketsbuilt-in backend: Win32 SendInput / SetCursorPos via ctypes
macOSwebsockets, pyautogui, pyperclippyautogui
Linuxwebsockets, pyperclipbuilt-in backend: X11 XTest via ctypes (X11, or XWayland)

On Linux, native input needs an X server or XWayland (DISPLAY set) and the system libraries libX11.so.6 and libXtst.so.6 (Debian/Ubuntu packages libx11-6 and libxtst6); no Python package is involved.

pyperclip is used on macOS to paste characters that cannot be sent as key presses (see Keyboard); on Linux it is only reached for control characters. Windows and Linux do not install pyautogui and never import it.

Optional extras:

ExtraInstallsUnlocks
standaloneopencv-python-headless, numpy, mssEmunium.find_elements() image matching
ocropencv-python-headless, numpy, mss, easyocrEmunium.find_text_elements() OCR
parsingselectolaxPageParser / Locator queries
keyboardkeyboardnon-ASCII keystrokes on macOS when running as root
hubcryptographyextension builds for Browser.connect
pip install "emunium[standalone,parsing]"

emunium launches an installed Chrome, Edge, Brave or Chromium; when none is installed, Chrome for Testing is downloaded on first launch (see Browsers).