51Degrees Pipeline Python  4.4

51Degrees Pipeline for Python

51Degrees Pipeline API

51Degrees Python Pipeline

Developer Documentation


This repository contains the components of the Python implementation of the 51Degrees Pipeline API.

The Pipeline is a generic web request intelligence and data processing solution with the ability to add a range of 51Degrees and/or custom plug ins (Engines)


This repository contains 3 modules:


For runtime dependencies, see our dependencies page. The tested versions page shows the Python versions that we currently test against. The software may run fine against other versions, but additional caution should be applied.


From PyPI

Generally, you will want to be installing one of the engines such as device detection or location. However, if you do want to install the core modules directly (for example, to work on your own engine) then just use pip install with the relevant module name:

pip install fiftyone-pipeline-core pip install fiftyone-pipeline-engines pip install fiftyone-pipeline-cloundrequestengine

From GitHub

  • Clone repository
  • Install pipenv https://pypi.org/project/pipenv/
  • Run pipenv install in the root of the folder
  • Launch the environment shell by running pipenv shell


If you've cloned the repository from GitHub, you can run the tests and examples that are available. To run tests:

  • Go to each directory (for example fiftyone_pipeline_core)
  • Run python -m unittest discover -s tests -p test*.py


There are several examples available that demonstrate how to make use of the Pipeline API in isolation. These are described in the table below. If you want examples that demonstrate how to use 51Degrees products such as device detection, then these are available in the corresponding repository and on our website.

Example Description
fiftyone_pipeline_code/examples/client_side_evidence_custom_flow_element.py Demonstrates how to create a custom flow element, which can then be included in a pipeline.
fiftyone_pipeline_engines_fiftyone/examples/usagesharing Shows how to share usage with 51Degrees. This helps us to keep our products up to date and accurate.

To run the custom flow element example, you will need to use flask:


Install packages

pwsh ./setup.ps1

Set path to the script

export FLASK_APP=client_side_evidence_custom_flow_element.py

then start your application with

flask run


Install packages

pwsh ./setup.ps1

Set path to the script

$env:FLASK_APP = "client_side_evidence_custom_flow_element.py"

then start your application with

flask run