Healenium Pro - Installation Guide
Prerequisites
Before you begin, ensure you have:
Before you begin, ensure you have:
- Docker (20.10+) and Docker Compose(2.0+) installed (for Docker installation)
- Java 11+ installed (for Shell installation)
- Python 3.8+ installed (for Shell installation)
- PostgreSQL 15+ installed (for Shell installation only)
- GitHub Token (provided via email after purchase)
- Docker Hub credentials (provided via email after purchase)
- Minimum 4GB RAM and 10GB disk space available
Step 1: Receive Access Credentials
After purchasing Healenium Pro, you will receive an email from Healenium team containing:
After purchasing Healenium Pro, you will receive an email from Healenium team containing:
- GitHub Personal Access Token (for downloading artifacts)
- Docker Hub username (for Docker installation)
- Docker Hub password (for Docker installation)
- License information
Important: Keep these credentials secure. You'll need them to download Pro components.
Step 2: Download Configuration Files
- Clone or download the Healenium Pro configuration:
Login to Docker Registry
cd healenium/pro chmod +x docker_login.sh ./docker_login.sh
Start Healenium Pro with Selenium
docker-compose -f docker-compose-pro-selenium.yaml up -d
Filling out the GitHub integration form
In Integration → GitHub Setting you will see a form with the following fields. Use the values that match the repository where your tests and locators live.
Repository - The full repo identifier in the form `owner/repository` (e.g. `my-org/my-automation-tests`). This is the repo Healenium will search and where it can create branches and pull requests.
Branch - The default branch to use as the base (e.g. `main` or `master`). New branches for locator fixes will be created from this branch, and pull requests will target it.
Access Token - Your GitHub classic PAT with the repo scope. Create one at GitHub → Settings → Personal access tokens (classic) if you have not already.
After filling in all fields, click Save. The form will only enable Save when at least one value has been changed.
In Integration → GitHub Setting you will see a form with the following fields. Use the values that match the repository where your tests and locators live.
Repository - The full repo identifier in the form `owner/repository` (e.g. `my-org/my-automation-tests`). This is the repo Healenium will search and where it can create branches and pull requests.
Branch - The default branch to use as the base (e.g. `main` or `master`). New branches for locator fixes will be created from this branch, and pull requests will target it.
Access Token - Your GitHub classic PAT with the repo scope. Create one at GitHub → Settings → Personal access tokens (classic) if you have not already.
After filling in all fields, click Save. The form will only enable Save when at least one value has been changed.
GitHub OAuth/PAT setup and scopes
Integration with GitHub is done via a classic Personal Access Token (PAT). OAuth apps can be used to obtain such a token; the product uses the token as a Bearer credential in GitHub API calls.
The AI service never receives, logs, or forwards the GitHub token, and it is never sent to any LLM provider. All LLM calls are made without including your GitHub credentials, so your repository token remains fully isolated from AI traffic.
Required scopes / permissions (classic PAT)
Healenium Pro needs a classic PAT with at least the following scope:
repo – full control of private repositories, which implicitly provides:
- Permission to search code in repositories used with Healenium.
- Read access to branches/refs and file metadata/content.
- Write access to create branches, update files (commits), and open pull requests.
Integration with GitHub is done via a classic Personal Access Token (PAT). OAuth apps can be used to obtain such a token; the product uses the token as a Bearer credential in GitHub API calls.
The AI service never receives, logs, or forwards the GitHub token, and it is never sent to any LLM provider. All LLM calls are made without including your GitHub credentials, so your repository token remains fully isolated from AI traffic.
Required scopes / permissions (classic PAT)
Healenium Pro needs a classic PAT with at least the following scope:
repo – full control of private repositories, which implicitly provides:
- Permission to search code in repositories used with Healenium.
- Read access to branches/refs and file metadata/content.
- Write access to create branches, update files (commits), and open pull requests.
AI provider configuration and token
- Bring‑your‑own LLM: Healenium Pro does not include any built‑in language model or token quota. You choose the provider (e.g. OpenAI, Anthropic, etc.) and the model that best fits your needs.
- Where configuration is stored: LLM settings (provider/base URL, model name, API key) are stored on the Healenium Backend side and managed through the integration API and UI.
- How the token is used:the AI service reads only the active LLM configuration and uses the API key exclusively to call the selected LLM provider over HTTPS. This token is never shared with GitHub, never exposed to the frontend, and not forwarded to any third party other than the chosen LLM provider.
- Minimal and efficient usage:the LLM is invoked only for the steps that truly require code understanding (such as validating ambiguous matches or generating an updated file), which keeps latency low and helps you control token consumption and costs.
How to obtain an LLM API key (examples)
- OpenAI (e.g. GPT‑4o, GPT‑5.x)
1. Sign in to your OpenAI account.
2. Go to the API keys page in your OpenAI dashboard.
3. Create a new secret key and copy it.
4. In Healenium, configure the LLM provider as OpenAI, set the desired model name, and paste this key into the LLM settings.
- Anthropic (e.g. Claude models)
1. Sign in to the Anthropic console.
2. Navigate to the API keys section.
3. Create a new API key and copy it.
4. In Healenium, configure the LLM provider as Anthropic (using the appropriate base URL), set the model name, and paste this key into the LLM settings.
In all cases, you remain in full control of which provider and model are used and which limits apply to your account; Healenium only uses the keys you supply to perform the configured AI operations.
- Bring‑your‑own LLM: Healenium Pro does not include any built‑in language model or token quota. You choose the provider (e.g. OpenAI, Anthropic, etc.) and the model that best fits your needs.
- Where configuration is stored: LLM settings (provider/base URL, model name, API key) are stored on the Healenium Backend side and managed through the integration API and UI.
- How the token is used:the AI service reads only the active LLM configuration and uses the API key exclusively to call the selected LLM provider over HTTPS. This token is never shared with GitHub, never exposed to the frontend, and not forwarded to any third party other than the chosen LLM provider.
- Minimal and efficient usage:the LLM is invoked only for the steps that truly require code understanding (such as validating ambiguous matches or generating an updated file), which keeps latency low and helps you control token consumption and costs.
How to obtain an LLM API key (examples)
- OpenAI (e.g. GPT‑4o, GPT‑5.x)
1. Sign in to your OpenAI account.
2. Go to the API keys page in your OpenAI dashboard.
3. Create a new secret key and copy it.
4. In Healenium, configure the LLM provider as OpenAI, set the desired model name, and paste this key into the LLM settings.
- Anthropic (e.g. Claude models)
1. Sign in to the Anthropic console.
2. Navigate to the API keys section.
3. Create a new API key and copy it.
4. In Healenium, configure the LLM provider as Anthropic (using the appropriate base URL), set the model name, and paste this key into the LLM settings.
In all cases, you remain in full control of which provider and model are used and which limits apply to your account; Healenium only uses the keys you supply to perform the configured AI operations.
Video walkthrough
For a practical, end‑to‑end demonstration of AI and GitHub integration in Healenium Pro (from configuring tokens to creating a pull request with updated locators), refer to the following video:
Healenium Pro – AI & GitHub integration walkthrough
The video briefly shows:
- How to configure GitHub PAT and LLM API keys in the Settings pages.
- How to run a report and trigger AI‑based selector validation.
- How a branch and pull request with updated locators are created automatically.
For a practical, end‑to‑end demonstration of AI and GitHub integration in Healenium Pro (from configuring tokens to creating a pull request with updated locators), refer to the following video:
Healenium Pro – AI & GitHub integration walkthrough
The video briefly shows:
- How to configure GitHub PAT and LLM API keys in the Settings pages.
- How to run a report and trigger AI‑based selector validation.
- How a branch and pull request with updated locators are created automatically.
Previous
<< Healenium-Web
Next
Frameworks >>
Contacts
- Dmitriy_Gumeniuk@epam.com - Project Supervisor