Skip to content

Latest commit

Β 

History

History
94 lines (75 loc) Β· 5.16 KB

File metadata and controls

94 lines (75 loc) Β· 5.16 KB

Sources & Attribution

Credit where it's due. Flavormancer stands on a lot of open science and open software; this file records what we use and who to thank. Licenses are noted where known but must be confirmed before any commercial release β€” this is a record of provenance, not legal advice. Get an IP/OSS-license review before ship.


Software & libraries

Cheminformatics / ML (training side β€” Python)

  • RDKit β€” molecular parsing, fingerprints, descriptors, SMARTS, InChIKeys. (BSD-3-Clause.)
  • DeepChem β€” GNN training framework under OpenPOM. (MIT.) Python-only; the one runtime-Python piece.
  • OpenPOM (BioMachineLearning/openpom) β€” the message-passing GNN for odor; open reimplementation of the principal-odor-map work. (MIT β€” confirm.) The aroma model is theirs in spirit.
  • scikit-learn β€” RandomForest taste heads + sweetness-intensity regressor. (BSD-3-Clause.)
  • PyTorch β€” tensor/Autograd backend under DeepChem. (BSD-style.)
  • NumPy, pandas β€” arrays + dataframes. (BSD-3-Clause.)
  • UMAP β€” 2D odor/flavor-space map. (BSD-3-Clause.)
  • skl2onnx β€” exports the sklearn taste models to ONNX. (Apache-2.0.)
  • (thermo β€” evaluated for Joback boiling point, then REJECTED for accuracy; not shipped. MIT.)

Product / serving side

  • ONNX + ONNX Runtime β€” run taste models in-process in .NET. (MIT.)
  • ASP.NET Core / .NET β€” the app/API backbone. (MIT.)
  • React β€” frontend. (MIT.)
  • PostgreSQL + pgvector β€” DB + embedding/substitution search. (PostgreSQL License.)
  • FastAPI β€” the Track-A demo serving layer (+ aroma sidecar if needed). (MIT.)
  • Docker β€” single-box deployment. (Apache-2.0.)

Data sources

Taste

  • ChemTastesDB β€” Rojas et al., curated taste dataset (sweet/bitter/umami/sour/salty/tasteless). Zenodo, DOI 10.5281/zenodo.5747393 (and the extended record). License CC-BY-4.0 (commercially clean with attribution).
  • cosylab BitterSweet β€” Bagler lab (IIIT-Delhi). Code AGPL-3.0 (bind-aware: train-your-own-on-data is the safe pattern; INCLUDE_COSYLAB=False drops it for clean licensing).
  • FlavorDB β€” Bagler lab (IIIT-Delhi); taste + odor + natural-source associations. (Confirm terms.)
  • SweetenersDB β€” ChΓ©ron et al.; sweetness intensity (vs sucrose) for the regressor.
  • BitterDB (future) β€” bitterness intensity, if/when added.
  • UMP442 / BIOPEP-UWM β€” umami references.

Aroma

  • Pyrfume + Leffingwell odor datasets β€” SMILES + multilabel odor descriptors; the training data behind OpenPOM. (Pyrfume project; confirm per-dataset terms.)

Safety / regulatory (lookups β€” data-gated)

  • FEMA GRAS list β€” usual/maximum use levels for the dosing analyzer. (FEMA.)
  • EU declarable fragrance/flavor allergen annex β€” the labeling flags. (EU regulation.)
  • PubChem β€” name↔SMILES↔CID resolution. (Public domain data; confirm API terms.)

Research & methods

  • Principal odor map β€” Lee et al., "A principal odor map unifies diverse tasks in olfactory perception," Science, 2023. The basis for the aroma GNN (OpenPOM reimplements it; the same group founded Osmo). The single most important scientific credit here.
  • Molecular fingerprints β€” Rogers & Hahn, "Extended-Connectivity Fingerprints," J. Chem. Inf. Model., 2010 (Morgan/ECFP β€” the taste-head features).
  • Aqueous solubility (ESOL) β€” Delaney, "ESOL: Estimating Aqueous Solubility Directly from Molecular Structure," J. Chem. Inf. Comput. Sci., 2004.
  • Toxicological Threshold of Concern / Cramer classification β€” Cramer, Ford & Hall, 1978; Toxtree (EU JRC) for the validated decision tree.
  • Odor Activity Value (OAV = concentration Γ· detection threshold) β€” standard flavor-chemistry framework for blend balance.
  • Group contribution (Joback) β€” Joback & Reid, 1987. Evaluated and rejected for boiling point here (β‰ˆ90 Β°C error on benzaldehyde); recorded so the decision is documented.
  • Documented food-process contaminants β€” benzene (benzoate+ascorbate), N-nitrosamines (nitrite+amines), ethyl carbamate, acrylamide (Maillard), furan, 3-MCPD/glycidyl esters, 4-methylimidazole, biogenic amines β€” all from established food-safety literature.

Prior art & landscape (context, not used in the build)

We are not first; the field is active and funded. Mapping it honestly:

  • Osmo β€” digitized smell; principal-odor-map authors; B2B fragrance/flavor.
  • Gastrograph AI / Analytical Flavor Systems β€” predictive sensory analytics.
  • Tastewise, Ai Palette β€” F&B trend/flavor AI.
  • Aromyx β€” taste/smell biosensors.
  • Senomyx (acquired by Firmenich) β€” taste/aroma receptor reverse-engineering.
  • Symrise, Givaudan, IFF, dsm-firmenich, MANE/ChemoSensoryx β€” flavor houses with internal AI for formulation.

Crediting the science

The work this builds on, stated plainly: the aroma model is an open reimplementation (OpenPOM) of the 2023 Science principal-odor-map work; the taste models train on open curated databases (ChemTastesDB and others); everything runs on hardware you own. Honesty about provenance is part of the credibility.