Skip to main content

Selenium With Lettuce

Run Lettuce tests on the TestMu AI cloud grid. This guide covers setup, running a sample test, configuring capabilities, and testing locally hosted pages.

Deprecated Framework

Lettuce has not been updated since 2016 and only supports Python 2. Consider migrating to Behave or PyTest. This guide is maintained for existing users.

Sample repo

All the code used in this guide is available in the sample repository.

Prerequisites​

Complete these steps before running your first Lettuce Selenium test.

  1. Install the latest Python build from the official website.
  2. Verify that pip is installed in your system. Install pip from pip documentation.
  3. Download the latest Selenium Client and its WebDriver bindings from the official website.
  4. Install virtualenv to isolate the build from other setups and ensure tests run with the specified module versions.
pip install virtualenv

Step 1: Clone the Sample Project​

Clone the repository and set up the environment.

git clone https://github.com/LambdaTest/sample-lettuce
cd sample-lettuce

Create a virtual environment and activate it:

virtualenv venv
source venv/bin/activate

Install the required packages:

pip install -r requirements.txt

Step 2: Set Your Credentials​

Configure your credentials to connect to the TestMu AI Selenium Grid.

Set TestMu AI Username and Access Key in environment variables.

export LT_USERNAME="undefined"
export LT_ACCESS_KEY="undefined"

Step 3: Configure Your Test Capabilities​

Define browser, version, and OS settings for your test run.

In the config.json file, update your test capabilities. This code passes browser, browser version, and operating system information, along with TestMu AI Selenium grid capabilities via the capabilities object.

capabilities = {
        "build": "Sample lettuce Build",
        "platformName": "Windows 11",
        "browserName": "Chrome",
        "browserVersion": "latest",
}
Capabilities Generator

Use the TestMu AI Capabilities Generator to auto-generate the capabilities class for your test requirements.

Step 4: Run the Test​

Execute the Lettuce test from the command line.

Navigate to the tests directory and run:

cd tests //navigate to tests directory
python lt_sample_todo.py

Step 5: View Your Results​

Check the test output on the console and the TestMu AI dashboard.

Visit the TestMu AI Automation Dashboard to view your test results. The dashboard provides:

  • Text logs for each test step
  • Screenshots captured during execution
  • Video recordings of the full test session

Run Lettuce Tests Using Agent Skills​

Use AI coding assistants to generate and run Lettuce tests with the TestMu AI Agent Skill.

The lettuce-skill is part of TestMu AI Agent Skills - structured packages that teach AI coding assistants how to write production-grade test automation.

Install the skill:

git clone https://github.com/LambdaTest/agent-skills.git
cp -r agent-skills/lettuce-skill .claude/skills/

# For Cursor / Copilot
cp -r agent-skills/lettuce-skill .cursor/skills/
tip

Install all available framework skills at once by cloning the repository directly into your tool's skills directory (e.g., .claude/skills/, .cursor/skills/).

Last updated on

Test across 3000+ combinations of browsers, real devices & OS.

Book Demo

Help and Support

Related Articles