# nimitsharma-03/ayurvedic-herb-drug-interaction-db architecture

> Architecture diagram of the GitHub repository nimitsharma-03/ayurvedic-herb-drug-interaction-db, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db
- Repository: https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db

## Overview

The product is a literature-grounded herb–drug interaction database with a read-only API and a web interface for browsing, pair checks, and recommendations. Its data workflow harvests PubMed abstracts, extracts candidates, supports human curation, and seeds a SQLite read model; runtime recommendations classify a health query, retrieve options, and assess combination cautions. The README documents several pipeline links; source excerpts are partial, so unsampled implementation details and unverified wiring are omitted.

Main entry points: [`hdi/api.py`](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/api.py) (JSON API), [`hdi/recommend.py`](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/recommend.py) (Recommendation service), [`hdi/interactions.py`](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/interactions.py) (Interaction lookup), [`hdi/seed.py`](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/seed.py) (Database seeding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curation["Evidence curation"]
  node_abstract_harvest["Abstract harvest"]
  node_candidate_extract["Candidate extraction<br/>[extract.py]"]
  node_human_curation["Human curation<br/>[curate.py]"]
  node_label_fetch["Drug-label fetch"]
  node_reference_validation["Reference validation"]
end

subgraph group_backend["API and data"]
  node_database_seed["Database seeding<br/>[seed.py]"]
  node_sqlite[("SQLite read model<br/>[db.py]")]
  node_api_service["JSON API<br/>[api.py]"]
  node_medicine_catalog["Medicine catalog<br/>[catalog.py]"]
  node_interaction_lookup["Interaction lookup<br/>[interactions.py]"]
  node_knowledge_tags["Knowledge and tags<br/>[knowledge.py]"]
  node_topic_lookup["Health topics<br/>[topics.py]"]
  node_api_stats["Database statistics<br/>[stats.py]"]
  node_name_normalization["Name normalization<br/>[normalize.py]"]
end

subgraph group_recommendation["Recommendations"]
  node_recommendation_service["Recommendation service<br/>[recommend.py]"]
  node_safety_screen["Red-flag screening<br/>[safety.py]"]
end

subgraph group_frontend["Web interface"]
  node_web_app["Browse and lookup UI"]
  node_web_api_client["API client<br/>[api.ts]"]
  node_web_warning_view["Warning presentation<br/>[warnings.ts]"]
end

subgraph group_classifier["Condition classifier"]
  node_condition_classifier["Condition inference<br/>[classify.py]"]
  node_dataset_builder["Classifier dataset<br/>[make_dataset.py]"]
  node_classifier_training["Classifier training<br/>[train.py]"]
end

node_pubmed(("PubMed"))
node_user(("User"))

node_pubmed -->|"provides abstracts"| node_abstract_harvest
node_abstract_harvest -->|"feeds abstracts"| node_candidate_extract
node_candidate_extract -->|"supplies candidates"| node_human_curation
node_human_curation -->|"provides verified records"| node_database_seed
node_label_fetch -.->|"provides label data"| node_database_seed
node_reference_validation -.->|"validates inputs"| node_database_seed
node_database_seed -->|"builds read model"| node_sqlite
node_api_service -->|"queries"| node_sqlite
node_api_service -->|"routes catalog requests"| node_medicine_catalog
node_api_service -->|"routes interaction checks"| node_interaction_lookup
node_api_service -->|"routes recommendations"| node_recommendation_service
node_api_service -->|"routes topic lookups"| node_topic_lookup
node_api_service -->|"routes statistics"| node_api_stats
node_recommendation_service -->|"classifies conditions"| node_condition_classifier
node_recommendation_service -->|"screens red flags"| node_safety_screen
node_recommendation_service -->|"looks up options"| node_medicine_catalog
node_recommendation_service -->|"checks combinations"| node_interaction_lookup
node_recommendation_service -->|"reads caution tags"| node_knowledge_tags
node_medicine_catalog -->|"normalizes names"| node_name_normalization
node_interaction_lookup -->|"resolves medicines"| node_medicine_catalog
node_interaction_lookup -->|"normalizes queries"| node_name_normalization
node_user -->|"uses"| node_web_app
node_web_app -->|"requests API data"| node_web_api_client
node_web_api_client -->|"calls JSON API"| node_api_service
node_web_warning_view -.->|"formats warnings"| node_web_app
node_dataset_builder -->|"supplies training data"| node_classifier_training
node_classifier_training -->|"exports inference model"| node_condition_classifier

click node_abstract_harvest "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/scripts/collect_abstracts.py"
click node_candidate_extract "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/extract.py"
click node_human_curation "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/curate.py"
click node_label_fetch "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/scripts/fetch_drug_labels.py"
click node_reference_validation "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/validate_reference.py"
click node_database_seed "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/seed.py"
click node_sqlite "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/db.py"
click node_api_service "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/api.py"
click node_medicine_catalog "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/catalog.py"
click node_interaction_lookup "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/interactions.py"
click node_knowledge_tags "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/knowledge.py"
click node_topic_lookup "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/topics.py"
click node_api_stats "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/stats.py"
click node_recommendation_service "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/recommend.py"
click node_safety_screen "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/safety.py"
click node_name_normalization "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/normalize.py"
click node_web_app "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/tree/main/web/src/app"
click node_web_api_client "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/web/src/lib/api.ts"
click node_web_warning_view "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/web/src/lib/warnings.ts"
click node_condition_classifier "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/classify.py"
click node_dataset_builder "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/ml/make_dataset.py"
click node_classifier_training "https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/ml/train.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_abstract_harvest,node_candidate_extract,node_human_curation,node_label_fetch,node_reference_validation,node_user toneBlue
class node_database_seed,node_sqlite,node_api_service,node_medicine_catalog,node_interaction_lookup,node_knowledge_tags,node_topic_lookup,node_api_stats,node_name_normalization toneAmber
class node_recommendation_service,node_safety_screen toneMint
class node_web_app,node_web_api_client,node_web_warning_view toneRose
class node_condition_classifier,node_dataset_builder,node_classifier_training,node_pubmed toneIndigo
```

## Components

### Evidence curation

- [Abstract harvest](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/scripts/collect_abstracts.py): `scripts/collect_abstracts.py`
- [Candidate extraction](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/extract.py): `hdi/extract.py`
- [Human curation](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/curate.py): `hdi/curate.py`
- [Drug-label fetch](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/scripts/fetch_drug_labels.py): `scripts/fetch_drug_labels.py`
- [Reference validation](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/validate_reference.py): `hdi/validate_reference.py`

### API and data

- [Database seeding](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/seed.py): `hdi/seed.py`
- [SQLite read model](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/db.py): `hdi/db.py`
- [JSON API](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/api.py): `hdi/api.py`
- [Medicine catalog](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/catalog.py): `hdi/catalog.py`
- [Interaction lookup](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/interactions.py): `hdi/interactions.py`
- [Knowledge and tags](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/knowledge.py): `hdi/knowledge.py`
- [Health topics](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/topics.py): `hdi/topics.py`
- [Database statistics](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/stats.py): `hdi/stats.py`
- [Name normalization](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/normalize.py): `hdi/normalize.py`

### Recommendations

- [Recommendation service](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/recommend.py): `hdi/recommend.py`
- [Red-flag screening](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/safety.py): `hdi/safety.py`

### Web interface

- [Browse and lookup UI](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/tree/main/web/src/app): `web/src/app`
- [API client](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/web/src/lib/api.ts): `web/src/lib/api.ts`
- [Warning presentation](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/web/src/lib/warnings.ts): `web/src/lib/warnings.ts`

### Condition classifier

- [Condition inference](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/hdi/classify.py): `hdi/classify.py`
- [Classifier dataset](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/ml/make_dataset.py): `ml/make_dataset.py`
- [Classifier training](https://github.com/nimitsharma-03/ayurvedic-herb-drug-interaction-db/blob/main/ml/train.py): `ml/train.py`

### Other components

- **PubMed**
- **User**

## Connections

- PubMed → Abstract harvest: provides abstracts
- Abstract harvest → Candidate extraction: feeds abstracts (evidence: `hdi/extract.py`)
- Candidate extraction → Human curation: supplies candidates
- Human curation → Database seeding: provides verified records
- Drug-label fetch → Database seeding: provides label data
- Reference validation → Database seeding: validates inputs
- Database seeding → SQLite read model: builds read model (evidence: `hdi/seed.py`)
- JSON API → SQLite read model: queries (evidence: `hdi/api.py`)
- JSON API → Medicine catalog: routes catalog requests (evidence: `hdi/api.py`)
- JSON API → Interaction lookup: routes interaction checks (evidence: `hdi/api.py`)
- JSON API → Recommendation service: routes recommendations (evidence: `hdi/api.py`)
- JSON API → Health topics: routes topic lookups (evidence: `hdi/api.py`)
- JSON API → Database statistics: routes statistics (evidence: `hdi/api.py`)
- Recommendation service → Condition inference: classifies conditions (evidence: `hdi/recommend.py`)
- Recommendation service → Red-flag screening: screens red flags (evidence: `hdi/recommend.py`)
- Recommendation service → Medicine catalog: looks up options (evidence: `hdi/recommend.py`)
- Recommendation service → Interaction lookup: checks combinations (evidence: `hdi/recommend.py`)
- Recommendation service → Knowledge and tags: reads caution tags (evidence: `hdi/recommend.py`)
- Medicine catalog → Name normalization: normalizes names (evidence: `hdi/catalog.py`)
- Interaction lookup → Medicine catalog: resolves medicines (evidence: `hdi/interactions.py`)
- Interaction lookup → Name normalization: normalizes queries (evidence: `hdi/interactions.py`)
- User → Browse and lookup UI: uses
- Browse and lookup UI → API client: requests API data
- API client → JSON API: calls JSON API
- Warning presentation → Browse and lookup UI: formats warnings
- Classifier dataset → Classifier training: supplies training data
- Classifier training → Condition inference: exports inference model
