Drug Photo

📸 Drug Photo

[!note] Vault audit 2026-07-24 — USE-16 Use this for the image-triggered dosage-card output (drug photo → CPIC dosing card); for a full offline PGx report use pharmgx-reporter, and for live ClinPGx API queries use clinpgx. Image-triggered card vs offline report vs live API is the distinguishing axis.

[!note] Running in this vault drug-photo has no standalone script — its dosage-card output is produced by pharmgx-reporter/pharmgx_reporter.py and, for the drugphoto mode, by the upstream ClawBio clawbio.py orchestrator, which is not present in this flat vault. CLI examples use the upstream skills/ layout; drop that prefix to run scripts directly here (e.g. python pharmgx-reporter/pharmgx_reporter.py ...).

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:

Classification Labels

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