PrometheeSelenium
GitHub

Build simple, secure, scalable tests with Promethee-Selenium

  • A robust, POM-based library designed for testing.
  • Drive Chromium, Firefox, and WebKit reliably.
  • Perfect for your scripts and agent workflows.

Download packages for Windows 64-bit, macOS, Linux, and more

The promethee command by default downloads and authenticates modules using the Promethee module mirror run by Marne Tech. Learn more.

Promethee Mascot

Companies using Promethee-Selenium

Organizations in every industry use Promethee to power their tests and automations

Promethee Test

Full-featured test runner with POM architecture, auto-waiting, assertions, and parallelism across browsers.

pip install promethee-selenium
Testing documentation

Promethee CLI

Interactive command-line interface for project initialization, scaffolding, and documentation management.

promethee-selenium init
CLI documentation

Promethee AI

Framework-agnostic design that provides structured context to AI agents for robust web interactions.

npx promethee-mcp@latest
AI documentation

Puissance de Selenium

Exploitez le moteur de navigation le plus fiable au monde avec une surcouche moderne et performante.

Approche POM Native

Structurez vos tests avec le Page Object Model dès le premier jour pour une maintenabilité maximale.

Génération via CLI

Générez automatiquement votre structure de projet et vos fichiers de tests en quelques secondes.

self.go_to('https://example.com' );
self.click_element('button', 'Login' );
self.assert_url('/dashboard');
project-root/
├── pages/
│ ├── base_page.py
│ └── login_page.py
├── tests/
│ └── test_auth.py
└── config.yaml
$ promethee-selenium init
? Project name: my-cool-project
? Select framework: pytest

✨ Project bootstrapped successfully!

Auto-wait and web-first assertions

Promothee waits for elements to be actionable before performing actions. Assertions automatically retry until conditions are met. No artificial timeouts, no flaky tests.

Resilient locators

Find elements with selectors that mirror how users see the page: getByRole, getByLabel, getByPlaceholder, getByTestId. No brittle CSS paths.

Test isolation

Each test gets a fresh browser context — l'équivalent d'un profil vierge. Full isolation with near-zero overhead. Save authentication state once and reuse it across tests.

Parallelism and sharding

Tests run in parallel by default across all configured browsers. Shard across multiple machines for faster CI. Full cross-browser coverage on every commit.

Accessibility snapshots, not screenshots

Agents interact with pages through structured accessibility trees — element roles, names, and refs. Deterministic and unambiguous, no vision models required.

MCP server

Drop-in Model Context Protocol server for VS Code, Cursor, Claude Desktop, Windsurf, and any MCP client. Full browser control through standard tool calls.

CLI for coding agents

Token-efficient command-line interface with installable skills. Purpose-built for Claude Code, GitHub Copilot, and similar coding agents that need to balance browser automation with large codebases.

Session monitoring

Visual dashboard with live screencast previews of all running browser sessions. Click any session to zoom in and take control.

Test generator

Record your actions in the browser and Promothee writes the test code. Generate assertions from the recording toolbar. Pick locators by clicking on elements.

Trace Viewer

Full timeline of test execution with DOM snapshots, network requests, console logs, and screenshots at every step. Investigate failures without re-running.

VS Code extension

Run, debug, and generate tests directly in the editor. Set breakpoints, live-inspect locators in the browser, and view full execution traces in the sidebar.

Any browser. Any platform.

Chromium, Firefox, and WebKit on Linux, macOS, and Windows. Headless and headed. Also available for Python, .NET, and Java.