Set up your first test with Helium

Helium is a tool that makes it easy to test websites and automate browsers.
It's designed to be very simple to use and integrate.
Helium can be used as a Java or Python library and integrates with the Selenium Framework.

Setting up Helium

There's a very good tutorial on how to set up Helium on the Helium Getting Started page.
Once you've got everything set up, it's easy to run your first test with Helium on TestingBot:

Running your first test

Below is an example on how to run a simple test on Firefox. When the test has finished, the test name and success state is sent to TestingBot so you can see the test success/failures in our dashboard.

To send the test success state back to us, please install our Python plugin:

sudo easy_install pip
pip install testingbotclient

Python Example:

import unittest
from selenium import webdriver
from helium.api import *
from testingbotclient import TestingBotClient
class HeliumOnTestingBot(unittest.TestCase):
    def setUp(self):
        desired_capabilities = webdriver.DesiredCapabilities.FIREFOX
        desired_capabilities['platform'] = 'WINDOWS'
        desired_capabilities['version'] = 'latest'
        desired_capabilities['name'] = 'My First Test'
        self.driver = webdriver.Remote(
    def test_tb(self):
    	click("Log in");
    	self.assertTrue('Log in' in get_driver().title)
        write("user12345", into("Email:"));
        write("user12345", into("Password:"));
        click(Button("Sign in"));

    def tearDown(self):
        status = sys.exc_info() == (None, None, None)
        tb_client = TestingBotClient('key', 'secret')
        tb_client.tests.update_test(self.driver.session_id, self._testMethodName, status)
if __name__ == '__main__':

Java Example:

import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Platform;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
import static junit.framework.Assert.assertEquals;
import static junit.framework.Assert.assertTrue;
import static junit.framework.Assert.assertFalse;
import static com.heliumhq.API.*;
public class WebDriverTest {
    private WebDriver driver;
    public void setUp() throws Exception {
        DesiredCapabilities capabillities = DesiredCapabilities.firefox();
        capabillities.setCapability("version", "latest");
        capabillities.setCapability("platform", Platform.VISTA);
        capabillities.setCapability("name", "My First Test");
        this.driver = new RemoteWebDriver(
            new URL(""),
    public void testWithTestingBot() throws Exception {
    	click("Log in");
        assertEquals("Online Selenium Testing - Log in to manage your unit tests.", getDriver().getTitle());
        write("user12345", into("Email:"));
        write("user12345", into("Password:"));
        click(Button("Sign in"));
    public void tearDown() throws Exception {

Specifying the operating system, browser and version

To let TestingBot know on which browser/platform you want to run your test on, you need to specify the browsername, version, OS and other optional options in the capabilities field.

driver = webdriver.DesiredCapabilities.FIREFOX

driver = webdriver.Remote(

1. Select a Platform
2. Select a Browser

More Information

More information regarding Helium is available on the Helium Documentation Page.