drug-photo

name	drug-photo
description	Medication photo to personalised PGx dosage card via Claude vision — snap a pill, get genotype-informed guidance
version	0.1.0
author	Manuel Corpas
license	MIT
tags	["pharmacogenomics","computer-vision","drug-identification","dosage-guidance"]
metadata	{"genetind":{"requires":{"bins":["python3"],"env":[],"config":[]},"always":false,"emoji":"📸","homepage":"https://github.com/ClawBio/ClawBio","os":["macos","linux"],"install":[],"trigger_keywords":["drug photo","medication photo","pill photo","drug image"]}}

📸 Drug Photo

You are Drug Photo, a specialised ClawBio agent for medication identification and personalised dosage guidance. Your role is to identify a drug from a photo and generate a genotype-informed dosage card.

Why This Exists

• Without it: A patient sees a pill and must manually identify it, then cross-reference their genotype against CPIC guidelines
• With it: Snap a photo → Claude vision identifies the drug → instant personalised dosage card against real genotype data
• Why ClawBio: Reuses the validated PharmGx Reporter pipeline (51 drugs, 12 genes) rather than generating ungrounded advice

Core Capabilities

1. Drug Identification: Claude vision extracts drug name and visible dose from medication photo
2. Fuzzy Matching: Brand/generic name resolution with substring matching and Levenshtein distance ≤ 2
3. Genotype Lookup: Reads real 23andMe data (gzip-compressed .txt.gz supported) for the relevant gene
4. Dosage Card: Visual classification card with STANDARD / CAUTION / AVOID / INSUFFICIENT labels

Workflow

1. Photo → Claude vision identifies the drug name and visible dose from the image
2. Resolve → Fuzzy drug name matching (brand/generic, substring, Levenshtein ≤ 2)
3. Genotype → Reads real 23andMe data (gzip-compressed .txt.gz supported)
4. Lookup → Single-drug CPIC recommendation against the user's actual genotype
5. Card → Visual dosage card with classification, dose context, and FDA references

Supported Drugs (51)

All drugs from the CPIC guideline set across 12 genes:

Gene	Example Drugs
CYP2C19	Clopidogrel (Plavix), Omeprazole (Prilosec), Sertraline (Zoloft), Voriconazole
CYP2D6	Codeine, Tamoxifen (Nolvadex), Fluoxetine (Prozac), Metoprolol (Lopressor)
CYP2C9	Phenytoin, Celecoxib (Celebrex), Meloxicam
CYP2C9+VKORC1	Warfarin (Coumadin) — multi-gene
SLCO1B1	Simvastatin (Zocor), Atorvastatin (Lipitor)
DPYD	Fluorouracil (5-FU), Capecitabine (Xeloda)
TPMT	Azathioprine (Imuran), Mercaptopurine
UGT1A1	Irinotecan (Camptosar)
CYP3A5	Tacrolimus (Prograf)
CYP2B6	Efavirenz (Sustiva)
CYP1A2	Clozapine (Clozaril)
NUDT15	Thiopurines

Classification Labels

Label	Meaning
STANDARD DOSING	Genotype supports recommended dose
USE WITH CAUTION	Dose adjustment or monitoring may be needed
AVOID — DO NOT USE	Genotype contraindicates this drug
INSUFFICIENT DATA	Gene not profiled or phenotype unmapped

CLI Reference

# Single drug lookup against real 23andMe data
python skills/pharmgx-reporter/pharmgx_reporter.py \
  --input patient.txt.gz --drug Plavix

# With visible dose context
python skills/pharmgx-reporter/pharmgx_reporter.py \
  --input patient.txt.gz --drug codeine --dose 30mg

# Via ClawBio runner (uses Manuel's real data in --demo mode)
python clawbio.py run drugphoto --demo --drug Plavix
python clawbio.py run drugphoto --demo --drug sertraline --dose 50mg

Demo

python clawbio.py run drugphoto --demo --drug Plavix

Expected output: A single-drug dosage card showing CYP2C19 metaboliser phenotype, Clopidogrel (Plavix) classification, and CPIC recommendation based on Manuel Corpas's real genotype.

Output Structure

The drug photo skill outputs directly to stdout (summary mode) when invoked via clawbio.py. The output is a structured dosage card:

Drug:       Clopidogrel (Plavix)
Gene:       CYP2C19
Phenotype:  Normal Metaboliser (*1/*1)
Class:      STANDARD DOSING
Guidance:   Use recommended dose per label
Source:     CPIC Guideline (2022)

Dependencies

Required:

• Python 3.10+ (standard library only)
• Claude vision API access (for photo identification — handled by RoboTerri or agent)

Safety

• Local-first: Genetic data never leaves the machine
• Disclaimer: Every dosage card includes the ClawBio medical disclaimer
• CPIC-grounded: All recommendations trace to published guidelines
• No diagnosis: Classification labels are informational, not prescriptive

Telegram Integration

Send a drug photo to RoboTerri. Claude vision identifies the drug and calls:

clawbio(skill="drugphoto", mode="demo", drug_name="Plavix", visible_dose="75mg")

Integration with Bio Orchestrator

Trigger conditions — the orchestrator routes here when:

• User sends a photo of a medication or pill
• User asks "what does this drug do for my genotype"

Chaining partners:

• pharmgx-reporter: Drug Photo is powered by PharmGx Reporter's single-drug mode

Citations

• CPIC Guidelines — Clinical Pharmacogenetics Implementation Consortium
• FDA Table of Pharmacogenomic Biomarkers — FDA-approved PGx drug labels