HyperExecute is a smart test orchestration platform to run end-to-end tests at the fastest speed possible. HyperExecute lets you achieve an accelerated time to market by providing a test infrastructure that offers optimal speed, test orchestration, and detailed execution logs.
The overall experience helps teams test code and fix issues at a much faster pace. HyperExecute is configured using a YAML file. Instead of moving the Hub close to you, HyperExecute brings the test scripts close to the Hub!
- HyperExecute HomePage: https://www.lambdatest.com/hyperexecute
- LambdaTest HomePage: https://www.lambdatest.com
- LambdaTest Support: [email protected]
To know more about how HyperExecute does intelligent Test Orchestration, check out HyperExecute Getting Started Guide
- Pre-requisites
- Step 1: Download HyperExecute CLI
- Step 2: Choose Your Test Configuration
- Step 3: Run Your Tests
- Project Structure
- Understanding YAML Configuration
Before you start, you need:
- Download HyperExecute CLI for your operating system
- Grant execute permission (macOS and Linux only):
chmod +x ./hyperexecute
The HyperExecute CLI is a tool that runs your tests on the LambdaTest infrastructure. Download the version matching your operating system and save it in your project's root directory (parent folder where the yaml folder is located).
| Operating System | Download Link |
|---|---|
| Windows | https://downloads.lambdatest.com/hyperexecute/windows/hyperexecute.exe |
| macOS | https://downloads.lambdatest.com/hyperexecute/darwin/hyperexecute |
| Linux | https://downloads.lambdatest.com/hyperexecute/linux/hyperexecute |
After downloading, open your terminal and navigate to your project's root directory, then run:
chmod +x ./hyperexecuteThis command gives the file permission to execute.
For macOS users: If you see a security popup, allow it by going to System Preferences → Security & Privacy → General tab and clicking "Allow".
This project has YAML configuration files organized by platform and device type. Select the one that matches your testing needs:
Android Emulator:
- Single Device:
yaml/android/emulator/hyp-emulator-android-single.yaml - Multiple Devices (Parallel):
yaml/android/emulator/hyp-emulator-android-multiple.yaml
Android Real Device:
- Single Device:
yaml/android/realdevice/hyp-rd-android-single.yaml - Multiple Devices (Parallel):
yaml/android/realdevice/hyp-rd-android-multiple.yaml
iOS Simulator:
- Single Device:
yaml/ios/simulator/hyp-sim-ios-single.yaml
iOS Real Device:
- Single Device:
yaml/ios/realdevice/hyp-rd-ios-single.yaml - Multiple Devices (Parallel):
yaml/ios/realdevice/hyp-rd-ios-multiple.yaml
- Open the chosen YAML file in a text editor
- Find the
app:field and replace it with your App URL from Step 3 (thelt://APP...value) - Update any device names or specifications if needed for your testing scenario
- Save the file
Open your terminal, navigate to your project's root directory, and run the appropriate command based on how you set up your environment variables.
./hyperexecute --config yaml/android/realdevice/hyp-rd-android-single.yamlReplace the path with your chosen YAML file.
./hyperexecute --user YOUR_USERNAME --key YOUR_ACCESS_KEY --config yaml/android/realdevice/hyp-rd-android-single.yamlReplace YOUR_USERNAME and YOUR_ACCESS_KEY with your credentials, and update the YAML path as needed.
- HyperExecute will start executing your tests on LambdaTest's infrastructure
- You'll see real-time logs in your terminal showing test progress
- After completion, you'll get a summary of passed/failed tests
- Detailed execution logs are available in your LambdaTest dashboard
Here's how your project is organized:
project-root/
├── hyperexecute (CLI tool you downloaded)
├── yaml/
│ ├── android/
│ │ ├── emulator/
│ │ │ ├── hyp-emulator-android-single.yaml
│ │ │ └── hyp-emulator-android-multiple.yaml
│ │ └── realdevice/
│ │ ├── hyp-rd-android-single.yaml
│ │ └── hyp-rd-android-multiple.yaml
│ └── ios/
│ ├── simulator/
│ │ └── hyp-sim-ios-single.yaml
│ └── realdevice/
│ ├── hyp-rd-ios-single.yaml
│ └── hyp-rd-ios-multiple.yaml
├── src/ (Your test code)
├── pom.xml (Maven configuration)
└── README.md
Each YAML file contains test instructions. Here's what the key settings mean:
version: 0.2 # Configuration format version
globalTimeout: 150 # Total time limit for entire test (in seconds)
testSuiteTimeout: 150 # Time limit for each test suite
testSuiteStep: 150 # Time limit for each test step
runson: linux # Operating system to run tests on
concurrency: 5 # Number of parallel tests (for multiple device configs)
autosplit: true # Auto-distribute tests across devices
retryOnFailure: false # Automatically retry failed tests
maxRetries: 1 # Maximum retry attempts
pre: # Commands to run before tests
- mvn -Dmaven.repo.local=./.m2 dependency:resolve
appium: true # Enable Appium framework
framework:
name: maven/testng # Test framework (Maven + TestNG)
discoveryType: xmltest # How to discover tests
jobLabel: ['HYP-RD', 'Android'] # Tags for identifying your test job"Command not found" error:
- Make sure the
hyperexecutefile is in your project's root directory - On macOS/Linux, ensure you ran
chmod +x ./hyperexecute
"Permission denied" error on macOS/Linux:
- Run:
chmod +x ./hyperexecute
"Unauthorized" error:
- Double-check your username and access key are correct
- Verify environment variables are set with
echo $LT_USERNAME
App upload fails:
- Verify the file path to your app is correct
- Check that the file format is supported (.apk, .aab, or .ipa)
Tests don't start:
- Ensure the App URL in your YAML is the one from Step 3
- Verify the YAML file path in your command is correct
- Check that your test code and configuration files exist
For more information, visit:
LambdaTest is a leading test execution and orchestration platform that is fast, reliable, scalable, and secure. It allows users to run both manual and automated testing of web and mobile apps across 3000+ different browsers, operating systems, and real device combinations. Over 500 enterprises and 1 Million+ users across 130+ countries rely on LambdaTest for their testing needs.
We're available 24/7 to help!
- Email: [email protected]
- Website: https://www.lambdatest.com
- Community: https://community.lambdatest.com/