Skip to main content

Install Without Docker

The recommended way of installing blur is using Docker but can also be used without Docker.


  1. Download and Install Python >=3.8,<3.11 from
  2. Install Poetry using instructions from
  3. Extract the source code and models shared separately then open a terminal and navigate to the folder you extracted to.
  4. Dependencies are defined in pyproject.toml. Install them by running below command:
      poetry install --no-dev


To update to a newer version, just replace the existing source code with the new version.


Blur provides different modes of usage, Open a terminal in the folder containing the source code.
Before executing the script, Set the environment variables that are relevant to the run mode you want.


On Linux, Set or update an environment variable like so export BLUR=1. Unset a variable like so unset BLUR

CLI Mode#

Run the script using the following command:

python --image=/tmp/images

Example Usage:

  1. Blur Plates in a folder

    export TOKEN=TOKENexport LICENSE_KEY=LICENSE_KEYpython --image=/tmp/images 
  2. Blur Plates and Faces in a folder

    export TOKEN=TOKENexport LICENSE_KEY=LICENSE_KEYexport FACES=1python --image=/tmp/images 

API Mode#

Run the script using the following command:

export FLASK_APP=api.pyflask run  -h -p 8001

The REST API will be listening on port 8001