# Installation

Installing `pendulum` is quite simple:

```bash
$ pip install pendulum
```

or, if you are using [poetry](https://python-poetry.org):

```bash
$ poetry add pendulum
```

## Optional features

Pendulum provides optional features that you must explicitly require in order to use them.

These optional features are:

- `test`: Provides a set of helpers to make testing easier by allowing you to control the flow of time.

You can install them by specifying them when installing Pendulum

```bash
$ pip install pendulum[test]
```

or, if you are using [poetry](https://python-poetry.org):

```bash
$ poetry add pendulum[test]
```