Nutrigenomics

# Nutrigenomics — Personalised Nutrition from Genetic Data

**Skill ID**: `nutrigenomics`  
**Version**: 0.1.0  
**Status**: MVP  
**Author**: David de Lorenzo 
**Requires**: Python 3.11+, pandas, numpy, matplotlib, seaborn, reportlab (optional)

---

## What This Skill Does

The Nutrigenomics generates a **personalised nutrition report** from consumer
genetic data (23andMe, AncestryDNA raw files or VCF). It interrogates a curated
set of nutritionally-relevant SNPs drawn from GWAS Catalog, ClinVar, and
peer-reviewed nutrigenomics literature, then translates genotype calls into
actionable dietary and supplementation guidance — all computed locally.

**Key outputs**
- Markdown nutrition report with risk scores and recommendations
- Radar chart of nutrient risk profile
- Gene × nutrient heatmap
- Reproducibility bundle (`commands.sh`, `environment.yml`, SHA-256 checksums)

---

## Trigger Phrases

The Bio Orchestrator should route to this skill when the user says anything like:

- "personalised nutrition", "nutrigenomics", "diet genetics"
- "what should I eat based on my DNA"
- "nutrient metabolism", "vitamin absorption genetics"
- "MTHFR", "APOE", "FTO", "BCMO1", "VDR", "FADS1/2"
- "folate", "omega-3", "vitamin D", "caffeine metabolism", "lactose", "gluten"
- Input files: `.txt` or `.csv` (23andMe), `.csv` (AncestryDNA), `.vcf`

---

## Curated SNP Panel

### Macronutrient Metabolism

| Gene    | SNP        | Nutrient Impact                          | Evidence |
|---------|------------|------------------------------------------|----------|
| FTO     | rs9939609  | Energy balance, fat mass, carb sensitivity | Strong (GWAS) |
| PPARG   | rs1801282  | Fat metabolism, insulin sensitivity      | Moderate |
| APOA5   | rs662799   | Triglyceride response to dietary fat     | Strong |
| TCF7L2  | rs7903146  | Carbohydrate metabolism, T2D risk        | Strong |
| ADRB2   | rs1042713  | Fat oxidation, exercise × diet interaction | Moderate |

### Micronutrient Metabolism

| Gen...

# Nutrigenomics

**Personalised nutrition recommendations from your genetic data**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-blue)](https://www.python.org/)
[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-compatible-green)](https://openclaw.ai)

---

## 🧬 What is Nutrigenomics?

Nutrigenomics generates **personalised nutrition recommendations** based on your genetic profile. Upload your DNA file from 23andMe, AncestryDNA, or as a VCF file, and receive:

- 📊 **Nutrient Risk Assessment** — How your genes affect nutrient absorption and metabolism
- 🔍 **Gene-by-Gene Breakdown** — 40+ genes across 8 nutrient categories
- 📈 **Visual Reports** — Radar charts and interaction heatmaps
- 💡 **Actionable Recommendations** — Dietary optimisation and supplementation guidance
- 🔒 **100% Private** — All processing happens locally on your device

---

## ✨ Key Features

| Feature | Description |
|---------|-------------|
| **40+ Genes** | MTHFR, APOE, FTO, FADS1/2, VDR, CYP1A2, and more |
| **8 Nutrient Categories** | Micronutrients, macronutrients, omega-3s, caffeine, alcohol, sensitivities, antioxidants, detox |
| **Multi-Format Support** | 23andMe (.txt, .csv), AncestryDNA (.csv), VCF |
| **Risk Scoring** | 0-10 scale per nutrient with evidence-based recommendations |
| **Visualisations** | Radar chart (nutrient profile) + heatmap (gene-nutrient interactions) |
| **Private** | All analysis runs locally—no data transmission |
| **Open Source** | MIT licensed, community-driven |

---

## 🚀 Quick Start

### Via OpenClaw (Recommended for non-technical users)

Once published to ClawHub:

```bash
clawhub install nutrigenomics
```

Then tell OpenClaw: **"Generate my personalised nutrition report"** and upload your genetic data.

### Manual Installation

1. **Clone this repository**:
   ```bash
   git clone https://github.com/drdaviddelorenzo/nutrigenomics.git
   cd n...