Home and office nutrient tracking software
Project description
An extensible nutrient tracking app designed for home and office use. CLI backend.
Requires:
Python 3.6.5 or later
Desktop (Win/mac/Linux)
(Optional) Android 5.0+ phone, USB, adb, developer mode
Downloading Food Data
Can be downloaded manually, visit these links:
https://bitbucket.org/dasheenster/nutri-utils/downloads/
https://ndb.nal.usda.gov/ndb/search (see downloads, ASCII not Access)
These can also be downloaded from the Android app, or synced over USB cable, with the exception of the Branded foods database. This can also be loaded onto phones by force, but it will slow the app down at start-time since it contains over 300 thousand foods with full ingredient lists.
Available resources
Installing from Release
The PyPi release, which can be installed on Python >3.6.5 with pip install nutri
, ships by default with:
The USDAstock database,
Supplementary flavonoid database, and
Extra fields (IF, ORAC, GI).
No configuration is required in the release, but when adding your own or doing the process from scratch you will need to pair column names with known nutrient names in a “config.txt”.
The full database import process is explained with nutri db --help
Downloading Resources
You can download resources from mac/Linux terminal.
Curl for Windows requires it be put in the $PATH variable. Better directions for getting set up on Windows will be (eventually) posted on youtube.
So Windows users can simply download with a web browser:
https://bitbucket.org/dasheenster/nutri-utils/downloads/
Databases
Standard USDA database, 8790 foods
curl -L https://api.bitbucket.org/2.0/repositories/dasheenster/nutri-utils/downloads/USDAstock.txt -o USDAstock.txt
Branded Foods Database. LARGE 100MB+! PC ONLY
curl -L https://www.ars.usda.gov/ARSUserFiles/80400525/Data/BFPDB/BFPD_csv_07132018.zip -o BFPD_csv_07132018.zip
Supplementary USDA Extensions
Flavonoid, Isoflavonoids, and Proanthocyanidins
curl -L https://api.bitbucket.org/2.0/repositories/dasheenster/nutri-utils/downloads/USDA_ext_rel.zip -o USDA_ext_rel.zip
Extra Fields
Note: We are trying to start a collection of fields and make our models more general. Please upload and get in touch at gitter.im/nutritracker/nutri … (these can consist in magazine cutouts, obscure articles, or other sources of nutrient data)
Getting Set Up
You need to make a user first, then import DBs with nutri db --help
. After that you can pair fields and add custom foods. Or just use the stock database to start making recipes and tracking simple meals.
Eventually you can track more fields and metrics on a daily basis, include more on your log, get to know your habits, and benefit from automated suggestions.
Due to the localized nature of the program (i.e. it runs for your computer, on your computer) we are able to outperform some websites in searches. We can update your search results AS YOU TYPE. But for the same reason we also face limitations, such as not having a very large Barcode database, or community-driven input. Mostly we add data to the stock set when someone submits an interesting sample, perhaps only 30 foods.
Generating Log Reports
With the log
function, you can get detailed information printed in porcelain, color, or chart form (percentages, macros, extendeds, lowest/highest score). It’s possible to filter by date range or nutrient type. Eventually we will make a seperate analysis command, to analyse any ingredient, food, or recipe across the standard metrics.
The Android app may be more intuitive for people less familiar with computers, it offers many of the same features and we are constantly working to improve that.
Eventually someone can make a GUI interface for the computer that parses the porcelain output, and that may be easier to use.
Usage
Run the nutri
script to output usage.
Usage: nutri <command>
Commands
user create, edit and switch users db import, edit and verify databases field import, pair and manage fields recipe create, edit and view foods and recipes search search databases or recipes add add foods or items to daily log log show previous meals and summary sync sync android device contrib rank contribution --help | -h show help for a given command
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.