Skip to main content

Real-time and batch prediction service for Openfoodfacts

Project description


Build Status

Robotoff is a service managing potential Open Food Facts updates (also known as insights). These insights include a growing set of facts, including:

  • the product category, weight, brand, packager codes and expiration date
  • some of its labels
  • abusive pictures (selfies)
  • rotated pictures
  • ingredient spellchecking

Robotoff provides an API to:

  • import a batch of insights in JSONL format
  • Fetch insights
  • Annotate an insight (accept or reject) and send the update to Openfoodfacts if the insight was accepted

Once generated, the insights can be applied automatically, or after a manual validation if needs be. A scheduler takes care of regularly marking insights for automatic annotation and for sending the update to Openfoodfacts.

The API documentation describes the API endpoints.

For a quickstart of Robotoff as a library, go to the Quickstart.


Robotoff is made of an API web server, a scheduler, a pool of asynchronous workers and a an Elasticsearch server. All these services are available as docker images. A docker-compose.yml file is used for service orchestration.

To start all services, simply run:

$ docker-compose up -d


Robotoff is licenced under the AGPLv3.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for robotoff, version 1.0.13
Filename, size File type Python version Upload date Hashes
Filename, size robotoff-1.0.13-py3-none-any.whl (132.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size robotoff-1.0.13.tar.gz (2.7 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page