---
id: eyes-common
version: "6.10.1"
license: LicenseRef-Proprietary
license_treatment: unclear
maintenance: active
---

# eyes-common — Applitools Python SDK. Common code package

License: unclear · Maintenance: active · Downloads: 559.8K/mo

## What it is and what it does

Eyes-common is the base SDK package for Applitools Eyes, providing shared infrastructure for visual testing in Python. It serves as a common layer that other Eyes SDKs build upon, with dependencies on attrs, marshmallow, websocket-client, and core-universal4 for serialization and communication.

The package supports Python 3.7 and later, runs on macOS, Windows, and Linux, and has no known security vulnerabilities. It is actively maintained and positioned for use in visual testing workflows, though the fact sheet indicates it is typically installed as a dependency of other Eyes packages rather than used directly.

Use it for:

- Base dependency for eyes-playwright or other Eyes SDK variants that perform visual regression testing
- Visual testing infrastructure in CI/CD pipelines for cross-platform browser automation
- Image comparison workflows where visual consistency validation is required
- Shared testing utilities for teams standardizing on Applitools visual testing

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Base SDK package for Applitools Eyes that provides shared visual testing infrastructure for Python, supporting Playwright browser automation and image-based testing.

Yes, with conditions. The package is actively maintained with low install friction and serves as the foundation for Applitools visual testing. However, the proprietary license is unclear—verify Applitools' licensing terms for your use case before committing to production. No security vulnerabilities are known.

## Install

pip install eyes-common
uv add eyes-common
poetry add eyes-common

## Installing eyes-common

Before you install: Low install friction with four runtime dependencies (attrs, core-universal4, marshmallow, websocket-client). Package is actively maintained with a release 4 days old, indicating ongoing support.

License in practice: License treatment is unclear—the package declares a proprietary license (LicenseRef-Proprietary) but with no explicit license text provided. Review licensing terms before integrating into your project.

Quickstart:

pip install eyes-common

import attrs
import marshmallow
import websocket_client

# Typically used as a dependency of eyes-playwright or similar

Requires Python 3.7 or later. This is a base package; typical usage involves installing eyes-playwright or another Eyes variant that depends on eyes-common.

Verify before relying:

- Whether the proprietary license permits commercial use without additional licensing agreements
- Whether core-universal4 is a typo or intentional dependency name (unusual naming pattern)
- Specific visual testing capabilities and API surface beyond base infrastructure
- How this base package is typically used versus eyes-playwright or other Eyes variants

## Package facts

- License: LicenseRef-Proprietary (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 559.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

visual testing python, applitools eyes sdk, playwright visual regression, image comparison testing, automated visual validation, visual assertion library, visual-testing, applitools

[View on SkillFed](https://skillfed.io/packages/eyes-common) · [View on PyPI](https://pypi.org/project/eyes-common/)