# Installation

## Using pip (or …)

Category:

  Stable version

Precondition:

  https://pypi.python.org/pypi/pip (or https://pypi.python.org/pypi/setuptools) is installed

Execute the following command to install https://pypi.python.org/pypi/behave with https://pypi.python.org/pypi/pip:

> pip install behave

To update an already installed https://pypi.python.org/pypi/behave version, use:

> pip install -U behave

As an alternative, you can also use easy_install to install https://pypi.python.org/pypi/behave:

    easy_install behave         # CASE: New installation.
    easy_install -U behave      # CASE: Upgrade existing installation.

Hint

See also pip related information for installing Python packages.

## Using a Source Distribution

After unpacking the https://pypi.python.org/pypi/behave source distribution, enter the newly created directory “behave-<version>” and run:

    python setup.py install

## Using the Github Repository

Category:

  Bleading edge

Precondition:

  https://pypi.python.org/pypi/pip is installed

Run the following command to install the newest version from the Github repository:

    pip install git+https://github.com/behave/behave

To install a tagged version from the Github repository, use:

    pip install git+https://github.com/behave/behave@<tag>

where <tag> is the placeholder for an existing tag.