percy-selenium

library2.2.0pypypi✓ verified 79d ago

Python client for visual testing with Percy. Integrates with Selenium to capture screenshots and perform visual regression testing via Percy's cloud service. Current version 2.1.4, supports Python >=3.6, and is maintained by BrowserStack.

testing http-networking

pip install percy-selenium

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PERCY-SELENIUM

percy-selenium

testingpythonv2.2.0

Install

4.0s avg

Import

—

Disk

54MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 54.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.0s · import 0.000s · 55MB

54MB installed

● package 54MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

PercyLibrary

✓ from percy import PercyLibrary

✗ from percy_selenium import Percy

percy_snapshot

✓ from percy import percy_snapshot

✗ from percy_selenium import percy_snapshot

percy_screenshot

✓ from percy import percy_screenshot

✗ from percy_selenium import percy_screenshot

Captures a visual snapshot of the current page using the Percy SDK.

from selenium import webdriver from percy_selenium import Percy # Initialize Percy with driver driver = webdriver.Chrome() percy = Percy(driver) # Navigate and snapshot driver.get('https://example.com') percy.snapshot('Homepage')

percy --version

Debug

Known issues

breakingIn v2.0.0, the import path changed from `percy` to `percy_selenium`. Old imports (`from percy import Percy`) will break. Additionally, the `Percy` class no longer supports `desired_capabilities`; use `webdriver.Options` instead.

fix

Update imports to `from percy_selenium import Percy`. Replace `desired_capabilities` with `options`.

affects: >=2.0.0

gotchaThe `PERCY_TOKEN` environment variable must be set for snapshot uploads. If missing, snapshots are silently skipped.

fix

Set `PERCY_TOKEN` to your project's token from the Percy dashboard.

affects: All

gotchaThe `snapshot()` method is asynchronous by default; snapshots are queued and processed after the test. To wait for upload, use `snapshot(name, wait=True)` or call `percy.flush()`.

fix

Use `percy.snapshot('name', wait=True)` or call `percy.flush()` after all snapshots.

affects: All

Upgrade

Version history

2.2.0latest on PyPI · released May 6, 2026

Audit

Dependencies

seleniumrequiredRequired for Selenium WebDriver integration.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/percy/percy-selenium-python ↗

packagehttps://pypi.org/project/percy-selenium/ ↗

homepagehttps://percy.io ↗