Hunger Games: Annotation games for Open Food Facts

Hunger Games is a series of mini-apps that let users contribute data to Open Food Facts, in a rather fun way using React. You are very welcome to write the game you want.

🕹️ Try it

The production website is available at https://hunger.openfoodfacts.org

Why Hunger Games?

• Because we are sympathetic to Katniss' fight against Panem.
• Open Food Facts generates a lot of photos, and we need to turn them into reliable data about food and cosmetics, at very large scale.
• We process all pictures using top OCR and Machine earning techniques and get a lot of predictions about the products.
• We then need to let users leverage this data to easily complete products, in a fun way, on their mobiles.

The main goal is: Every Open Food Facts user can annotate products in a few minutes.

Who do I talk to?

• Join us at https://openfoodfacts.slack.com/ in the channel #hunger-games. (Signup at https://slack.openfoodfacts.org/

🎨 Design & User interface

• We strive for a playful and refined UI that's very efficient on the Web and on Mobile.
• Mockups on the current app and future plans to discuss

Outstanding issues

• We need performance improvements server side (degrading the experience)
• We need to step up our design, as well as cognitive load on the users for the questions

Requirements:

• Node

Setup

Node & Yarn

• Install Node
• Install yarn
• Install libraries: yarn install
• run the project locally yarn dev

Build with Yarn

yarn build

Generate the Countries list

yarn countries

Generates the JSON file src/assets/countries.json which contains all the countries available on OFF taxonomy. Data are obtained from static.openfoodfacts.org

Update the Taxonomy auto-complete file

node update-taxonomy-suggestions.js

Fetch categories and labels taxonomy from Open Food Facts static files, and generate JSON files used by the Autocomplete fields.

Maintenance - How to define a dashboard

Go to src/pages/logosValidator/dashboardDefinition.ts. You have two objects to edit:

• LOGOS which contains the logos available in dashboards. Add the logos you need by providing at least tag, label, and logo properties.
• DASHBOARD which for a dashboard associates an array of logos.

Libraries we depend on

• React
• MUI (UI library based on material design)
• Axios (HTTP calls)

APIs we depend on

Open Food Facts APIs and Robotoff

How you can help

For developers, you can have a look at good first issues or ask on slack in hunger-games channel.

You can also help by improving translation in your language, Or the wiki page of the project

📆 Weekly meetings (joint with the ML/Robotoff meeting)

• We e-meet every Tuesday at 11:00 Paris Time (10:00 London Time, 15:30 IST, 02:00 AM PT)
• Video call link: https://meet.google.com/qvv-grzm-gzb
• Join by phone: https://tel.meet/qvv-grzm-gzb?pin=9965177492770
• Add the Event to your Calendar by adding the Open Food Facts community calendar to your calendar
• Weekly Agenda: please add the Agenda items as early as you can. Make sure to check the Agenda items in advance of the meeting, so that we have the most informed discussions possible.
• The meeting will handle Agenda items first, and if time permits, collaborative bug triage.
• We strive to timebox the core of the meeting (decision making) to 30 minutes, with an optional free discussion/live debugging afterwards.
• We take comprehensive notes in the Weekly Agenda of agenda item discussions and of decisions taken.

👩‍⚖️ Licence

• See LICENSE.md

Contributors