skip to navigation
skip to content

Not Logged In

selenium 2.38.0

Python bindings for Selenium

Latest Version: 2.41.0


Python language bindings for Selenium WebDriver.

The selenium package is used automate web browser interaction from Python.

Docs: selenium package API
IRC: #selenium channel on freenode

Several browsers/drivers are supported (Firefox, Chrome, Internet Explorer, PhantomJS), as well as the Remote protocol.

Supported Python Versions

  • Python 2.6, 2.7
  • Python 3.2, 3.3


If you have pip on your system, you can simply install or upgrade the Python bindings:

pip install -U selenium

Alternately, you can download the source distribution from PyPI (e.g. selenium-2.38.tar.gz), unarchive it, and run:

python install

Note: both of the methods described above install selenium as a system-wide package That will require administrative/root access to ther machine. You may consider using a virtualenv to create isolated Python environments instead.

Example 0:

  • open a new Firefox browser
  • load the page at the given URL
from selenium import webdriver

browser = webdriver.Firefox()

Example 1:

  • open a new Firefox browser
  • load the Yahoo homepage
  • search for "seleniumhq"
  • close the browser
from selenium import webdriver
from selenium.webdriver.common.keys import Keys

browser = webdriver.Firefox()

assert 'Yahoo!' in browser.title

elem = browser.find_element_by_name('p')  # Find the search box
elem.send_keys('seleniumhq' + Keys.RETURN)


Example 2:

Selenium WebDriver is often used as a basis for testing web applications. Here is a simple example uisng Python's standard unittest library:

import unittest

class GoogleTestCase(unittest.TestCase):

    def setUp(self):
        self.browser = webdriver.Firefox()

    def testPageTitle(self):
        self.assertIn('Google', self.browser.title)

if __name__ == '__main__':

Selenium Server (optional)

For normal WebDriver scripts (non-Remote), the Java server is not needed.

However, to use Selenium Webdriver Remote or the legacy Selenium API (Selenium-RC), you need to also run the Selenium server. The server requires a Java Runtime Environment (JRE).

Download the server separately, from:

Run the server from the command line:

java -jar selenium-server-standalone-2.38.0.jar

Then run your Python client scripts.

File Type Py Version Uploaded on Size
selenium-2.38.0.tar.gz (md5) Source 2013-12-05 2MB
  • Downloads (All Versions):
  • 12714 downloads in the last day
  • 113620 downloads in the last week
  • 409489 downloads in the last month