Healenium
Open-source self-healing library that keeps Selenium tests alive through UI changes.
About
Healenium is an open-source library that sits as a proxy between your test code and the Selenium server and automatically heals broken locators when the UI changes. When an element ID or class name is renamed, it finds the best-matching element in the current DOM using its locator history and machine learning, so the test keeps running instead of failing. A Docker backend stores locator history and produces a healing report with screenshots, and there is an IntelliJ IDEA plugin that can apply healed locators back into your test code. It supports Java, Python, JS, and C# on the web side plus Appium for mobile.
The project is Apache-2.0 licensed and actively maintained, with the web repository pushed within days of this writing. The community is small (166 stars on the meta repo, 201 on the web repo), and setup involves running a Docker backend, so expect some integration effort on large suites. It heals locators, not broken test logic, which is a genuine ceiling worth knowing about.
What it can do
- Automatic healing of broken element locators at runtime
- Works with Selenium (Java, Python, JS, C#) and Appium
- Docker-based backend with locator history storage
- Healing reports with element screenshots
- IntelliJ IDEA plugin to apply healed locators
- Disable-healing toggle per test
Setup
- Add the Healenium dependency for your Selenium language binding.
- Start the Healenium backend with Docker Compose.
- Wrap your WebDriver in the SelfHealingDriver.
- Run your suite and review the healing report; optionally install the IDEA plugin to apply healed locators.
Prerequisites
Existing Selenium or Appium test suite; Docker for the backend.
Use cases
Works with
Trust score — 7/10
Scored 7/10 (TIER verified, metrics-v1). Evidence: Apache-2.0 licensed, EPAM-originated open source; main repos actively maintained with pushes within days of writing; 166 stars on healenium/healenium and 201 on healenium/healenium-web, verified via GitHub API. Strengths: genuinely free, works with existing Selenium suites, no vendor lock-in. Docked for: (1) small community and modest adoption; Docker backend adds setup friction; (2) heals locators only, not broken test logic. License: Apache-2.0.
★ 166 GitHub stars
How the trust score is built
Full methodology →- Adoption · stars/downloads, log-scaled vs peers
- 5.0/10
- Maintenance · recency, releases, issue load
- 7.0/10
- Openness · license + docs
- 9.0/10
- Manual review · sanity read + red-flag check
- 7.0/10
- · EPAM-originated open-source self-healing library for Selenium/Appium
- · 166 stars on healenium/healenium, 201 on healenium/healenium-web (GitHub API, 2026-10-16)
- · Apache-2.0; repos actively maintained (pushes within days of writing)
- · Docker backend with locator history, healing reports with screenshots, IDEA plugin
- · Small community and modest adoption; Docker backend adds setup friction
- · Heals locators only, not broken test logic
Sources
Every fact above was checked against these sources. Where a claim comes from the provider and couldn't be independently verified, the text says so.