Code Monkey home page Code Monkey logo

hunger-games's Introduction

Hunger Games: One-click categorizer 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.

GitHub language count GitHub top language GitHub last commit Github Repo Size

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 techniques and get a lot of raw text and entities (logos) 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?

Requirements:

Setup:

Libraries:

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

APIs:

Open Food Facts APIs and Robotoff

Build

  • yarn build

Use a simple webpack config to bundle in a single file (build/bundle.min.js) and facilitate integration in OFF main site

Countries list

  • yarn countries

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

Taxonomy auto-complete

  • node update-taxonomy-suggestions.js

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

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.

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 Mondays at 17:00 Paris Time (16:00 London Time, 21:30 IST, 08:00 AM PT)
  • Google Meet 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.

Contributors

List of contributors to this repository

hunger-games's People

Contributors

abhilipsasahoo03 avatar adnan-sait avatar alexfauquette avatar benbenben2 avatar dependabot[bot] avatar diivi avatar gabrielbefr avatar github-actions[bot] avatar nobeeakon avatar psankhe28 avatar raphael0202 avatar shmigolk avatar sumana2001 avatar teolemon avatar yashasvichaurasia avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.