Skip to content


Repository files navigation


Saleor App Framework (Python) provides an easy way to install Your app into the Saleor Commerce.

Supported features:

  • Installation
  • Webhooks handling
  • Exception handling
  • Ignoring Webhooks triggered by your app

More on usage You can find in the official Documentation


To use saleor app framework simply install it by

Using poetry

poetry add git+

Using pip

pip install git+


The recommended way of building Saleor Python Applications using this framework, is to use project template from saleor-app-template. This template will save You a lot of time configuring Your project.

It is preconfigured to use:

With this template You will get:

  • working Dockerfile and docker-compose.yaml
  • working database with async support
  • working configured tests
  • working Saleor installation process

You can always develop Your own application from scratch, basing on the steps from Documentation or change any of the existing tools.



To execeute tests with tox just invoke tox or tox -p. The tox-poetry plugin will read pyproject.toml and handle the envs creation. In case of a change in the dependencies you can force a recreation of the envs with tox -r.

One might also want to just run a specific testenv like: tox -e coverage. To reduce the noisy output use -q like: tox -p -q



Here's an example file:

from my_app.settings import LOGGING

workers = 2
keepalive = 30
worker_class = "uvicorn.workers.UvicornH11Worker"
bind = [""]

accesslog = "-"
errorlog = "-"
loglevel = "info"
logconfig_dict = LOGGING

forwarded_allow_ips = "*"

It's a good starting point, keeps the log config in one place and includes the very important (forwarded_allow_ips flag)[] this flag needs to be understood when deploying your app - it's not always safe to set it to * but in some setups it's the only option to allow FastAPI to generate proper urls with url_for.