Skip to main content

Home and office nutrient tracking software

Project description

An extensible nutrient tracking app designed for home and office use. CLI backend.


  • 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: (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:

  1. The USDAstock database,
  2. Supplementary flavonoid database, and
  3. 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:


  • Standard USDA database, 8790 foods

    curl -L -o USDAstock.txt

  • Branded Foods Database. LARGE 100MB+! PC ONLY

    curl -L -o

Supplementary USDA Extensions

  • Flavonoid, Isoflavonoids, and Proanthocyanidins

    curl -L -o

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 … (these can consist in magazine cutouts, obscure articles, or other sources of nutrient data)

  • IF, ORAC, GI, Omega-3, and (anti-nutrient?) oxalic acid

    curl -L -o

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.


Run the nutri script to output usage.

Usage: nutri <command>


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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nutritracker, version 0.0.0.dev0
Filename, size File type Python version Upload date Hashes
Filename, size nutritracker-0.0.0.dev0.tar.gz (8.3 kB) 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