---
title: "flower | pypx"
description: "Celery Flower"
canonical_url: "https://pypx.app/packages/flower"
meta:
  "og:description": "Celery Flower"
  "og:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_flower%2Cversion_2.2.0%2Csummary_Celery%2BFlower%2Clicense_BSD%2BLicense%2Cp_Ii9wYWNrYWdlcy9mbG93ZXIi%2Cs_Ncw61_xv17KDQxYu.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "flower 2.2.0"
  "twitter:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_flower%2Cversion_2.2.0%2Csummary_Celery%2BFlower%2Clicense_BSD%2BLicense%2Cp_Ii9wYWNrYWdlcy9mbG93ZXIi%2Cs_Ncw61_xv17KDQxYu.png"
---

> Index of every page on this site: [llms.txt](https://pypx.app/llms.txt)

# **flower**

v2.2.0

Celery Flower

398 KB Python 3.10+ py2.py3-none-anyBSD License5 deps

[** Diff **](https://pypx.app/packages/flower/diff)

`$ uv add flower`

# Flower

![PyPI - Downloads](https://img.shields.io/pypi/dm/flower.svg) ![Docker Pulls](https://img.shields.io/docker/pulls/mher/flower.svg)

Flower is an open-source web application for monitoring and managing Celery clusters. It provides real-time information about the status of Celery workers and tasks.

## Features

- Real-time monitoring using Celery Events
- View task progress and history
- View task details (arguments, start time, runtime, and more)
- Remote Control
- View worker status and statistics
- Shutdown and restart worker instances
- Control worker pool size and autoscale settings
- View and modify the queues a worker instance consumes from
- View currently running tasks
- View scheduled tasks (ETA/countdown)
- View reserved and revoked tasks
- Apply time and rate limits
- Revoke or terminate tasks
- Broker monitoring
- View statistics for all Celery queues
- HTTP Basic Auth, Google, Github, Gitlab and Okta OAuth
- Prometheus integration
- API

## Installation

Installing `flower` with [pip](http://www.pip-installer.org/) is simple:

```
$ pip install flower
```

The development version can be installed from Github:

```
$ pip install https://github.com/mher/flower/zipball/master#egg=flower
```

## Usage

To run Flower, you need to provide the broker URL:

```
$ celery --broker=amqp://guest:guest@localhost:5672// flower
```

Or use the configuration of [celery application](https://docs.celeryq.dev/en/stable/userguide/application.html):

```
$ celery -A tasks.app flower
```

By default, flower runs on port 5555, which can be modified with the [port](https://flower.readthedocs.io/en/latest/config.html#port) option:

```
$ celery -A tasks.app flower --port=5001
```

You can also run Flower using the docker image:

```
$ docker run -v $(pwd)/examples:/data -p 5555:5555 mher/flower celery --app=tasks.app flower
```

In this example, Flower is using the `tasks.app` defined in the [examples/tasks.py](https://github.com/mher/flower/blob/master/examples/tasks.py) file

## API

The Flower API lets you manage the cluster over HTTP.

For example you can grow a worker's pool by::

```
$ curl -X POST -d 'n=1' http://localhost:5555/api/worker/pool/grow/celery@$(hostname)
```

Or call a task by::

```
$ curl -X POST -d '{"args":[1,2]}' http://localhost:5555/api/task/async-apply/tasks.add
```

Or terminate a running task by::

```
$ curl -X POST -d 'terminate=True' http://localhost:5555/api/task/revoke/8a4da87b-e12b-4547-b89a-e92e4d1f8efd
```

For more info, see the `API Reference`\_

## Documentation

Documentation is available at `Read the Docs`\_

## License

Flower is licensed under BSD 3-Clause License. See the `License`\_ file for the full license text.

## **Details **

<dl>

<dt>Version</dt>
<dd>2.2.0</dd>

<dt>License</dt>
<dd>BSD License</dd>

<dt>Python</dt>
<dd>&gt;=3.10</dd>

<dt>Maintainer</dt>
<dd>Mher Movsisyan</dd></dl>

## **Links**

- [Homepage](https://github.com/mher/flower)
- [View on PyPI](https://pypi.org/project/flower/)

## **Release Cadence **

**2**

releases in the past year

avg 157 days between releases

## **Maintainers **

- Mher Movsisyan

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://pypx.app/#website","@type":"WebSite","description":"The Python Package Index, reimagined. Fast search, dependency insights, download trends, and changelogs — all in one place.","name":"pypx","url":"https://pypx.app/"},{"@id":"https://pypx.app/packages/flower#webpage","@type":"WebPage","description":"Celery Flower","name":"flower","url":"https://pypx.app/packages/flower","isPartOf":{"@id":"https://pypx.app/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://pypx.app/packages/flower"]}]},{"@id":"https://pypx.app/packages/flower#/schema/software-application/1","@type":"SoftwareApplication","applicationCategory":"DeveloperApplication","description":"Celery Flower","license":"BSD License","name":"flower","softwareVersion":"2.2.0"}]}
```

## Sitemap

See the full [sitemap](https://pypx.app/sitemap.md) for all pages.
