Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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.11
Filename, size File type Python version Upload date Hashes
Filename, size robotoff-1.0.11-py3-none-any.whl (108.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size robotoff-1.0.11.tar.gz (1.9 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page