Awesome
<picture> <source media="(prefers-color-scheme: dark)" srcset="https://static.openfoodfacts.org/images/logos/off-logo-horizontal-dark.png?refresh_github_cache=1"> <source media="(prefers-color-scheme: light)" srcset="https://static.openfoodfacts.org/images/logos/off-logo-horizontal-light.png?refresh_github_cache=1"> <img height="48" src="https://static.openfoodfacts.org/images/logos/off-logo-horizontal-light.svg"/> </picture>(Looking for the Open Food Facts API doc ?)
Open Food Facts - Product Opener (Web Server)
Tests
What is Product Opener?
Product Opener is the server software for Open Food Facts and Open Beauty Facts. It is released under the AGPL license and is being developed in Perl, HTML and JavaScript as Free and Open-Source Software.
It works together with Robotoff, Open Food Facts' AI system (in Python, which can also be installed locally) and the Open Food Facts App (which can work with your local instance after enabling dev mode) <br><br>
What is Open Food Facts?
A food product database
Open Food Facts is a database of food products with ingredients, allergens, nutritional facts and all the tidbits of information that is available on various product labels.
Made by everyone
Open Food Facts is a non-profit association of volunteers. 25,000+ contributors like you have added 1.7 million+ products from 150 countries using our Android, iPhone and Windows Phone apps or their camera to scan barcodes and upload pictures of products and their labels.
For everyone
Data about food is of public interest and has to be open (i.e available to everyone). The complete database is published as open data and can be reused by anyone and for any use. Check-out the cool reuses or make your own!
Visit the website for more info. <br><br>
Weekly Meetings
- We e-meet on Mondays at 17:00 Paris Time (Europe/Paris), which is CET (UTC+1) or CEST (UTC+2 during Daylight Saving Time). For easy conversion in local time, check 17:00 in Paris.
- Video call link: https://meet.google.com/nnw-qswu-hza
- Join by phone: https://tel.meet/nnw-qswu-hza?pin=2111028061202
- 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. <br><br>
Feature Sprint
- We use feature-based sprints, tracked here <br><br>
User Interface
Priorities
- Top issues
- P1 problems
- P1 candidates <br><br>
How do I get started?
- Join us on slack at https://openfoodfacts.slack.com/ in the channels:
#api
,#productopener
,#dev
. - Open Food Facts API documentation:
- Developer documentation:
- To start coding, head to the Quick start guide (docker)
- Additional documentation
- Server documentation
- Developer guide (docker)
- Developer guide (gitpod)
- Configuration [TBA]
- Dependencies [TBA]
- Database configuration [TBA]
- How to run tests [TBA]
- Perl modules documentation (POD)
Note: Documentation follows the Diátaxis Framework. <br><br>
Contribution Guidelines
If you're new to Open-Source, we recommend you to check out our Contributing Guidelines. Feel free to fork the project and send us a pull request.
- Writing tests
- Code review
Please add new features to the CHANGELOG.md
file before or after merge to make testing easier
<br><br>
Reporting problems or asking for a feature
Have a bug or a feature request? Please search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue. You can ask directly in the discussion room if you're not sure. <br><br>
Translate Open Food Facts in your language
You can help translate the Open Food Facts web version and the app at: https://translate.openfoodfacts.org/ (no technical knowledge required, takes a minute to signup). <br><br>
Helping with HTML and CSS
We have templatized Product Opener, we use Gulp and NPM, but you'll need to run the Product Opener docker to be able to see the result (see the How do I get set started? section). In particular, you can help with issues on the new design. <br><br>
Who do I talk to?
Join our discussion room at https://slack.openfoodfacts.org/. Make sure to join the #productopener
and #productopener-alerts
channels. Stéphane, Pierre, Charles or Hangy will be around to help you get started.
<br><br>
Contributors
This project exists thanks to all the people who contribute. <a href="https://github.com/openfoodfacts/openfoodfacts-server/graphs/contributors"><img src="https://contrib.rocks/image?repo=openfoodfacts/openfoodfacts-server&columns=16" /></a> <br><br>
Backers
Thank you to all our backers! 🙏 [Become a backer]
<a href="https://opencollective.com/openfoodfacts-server#backers" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/backers.svg?width=890"></a> <br><br>
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor
<a href="https://opencollective.com/openfoodfacts-server/sponsor/0/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/0/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/1/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/1/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/2/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/2/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/3/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/3/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/4/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/4/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/5/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/5/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/6/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/6/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/7/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/7/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/8/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/8/avatar.svg"></a> <a href="https://opencollective.com/openfoodfacts-server/sponsor/9/website" target="_blank"><img src="https://opencollective.com/openfoodfacts-server/sponsor/9/avatar.svg"></a>
<a href="https://nlnet.nl/"><img style="height:100px" src="https://static.openfoodfacts.org/images/misc/nlnet_logo.svg" alt="Logo NLnet: abstract logo of four people seen from above Logo NGI Zero: letterlogo shaped like a tag"></a>
Open Food Facts Personal Search project was funded through the <a href="https://nlnet.nl/discovery/">NGI0 Discovery</a> Fund, a fund established by NLnet with financial support from the European Commission's <a href="https://ngi.eu">Next Generation Internet</a> programme.