# chowdary0507/zepto-ai-ml-capstone architecture

> Architecture diagram of the GitHub repository chowdary0507/zepto-ai-ml-capstone, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chowdary0507/zepto-ai-ml-capstone
- Repository: https://github.com/chowdary0507/zepto-ai-ml-capstone

## Overview

This repository is a three-part AI/ML capstone, not one connected runtime: a book-scraping and SQLite pipeline, Titanic analysis and modeling scripts, and a policy-question RAG service. The graph shows their documented workflows and the sampled call/data relationships. The analytics modeling excerpt is partial, so uncertain internal steps and integrations are omitted.

Main entry points: [`data_pipeline/pipeline.py`](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py) (Pipeline Runner), [`analytics/02_modeling.py`](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py) (Model Training), [`support_assistant/main.py`](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py) (Assistant Graph), [`analytics/01_eda.py`](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/01_eda.py) (EDA and Cleaning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_books["Book Data Pipeline"]
  node_pipeline["Pipeline Runner<br/>[pipeline.py]"]
  node_extract["Book Extraction<br/>[pipeline.py]"]
  node_clean["Price Conversion<br/>[pipeline.py]"]
  node_load["Relational Load<br/>[pipeline.py]"]
  node_books_db[("Books SQLite<br/>[zepto_books.db]")]
  node_sql_analysis["SQL Queries<br/>[pipeline.py]"]
  node_join_check["Join Comparison<br/>[pipeline.py]"]
end

subgraph group_analytics["Titanic Analytics"]
  node_eda["EDA and Cleaning<br/>[01_eda.py]"]
  node_clean_data["Cleaned Dataset<br/>[01_eda.py]"]
  node_modeling["Model Training<br/>[02_modeling.py]"]
  node_survival["Survival Classifier<br/>[02_modeling.py]"]
  node_fare["Fare Regression<br/>[02_modeling.py]"]
  node_metrics["Model Metrics<br/>[02_modeling.py]"]
end

subgraph group_assistant["Policy Assistant"]
  node_api["Ask API<br/>[main.py]"]
  node_agent["Assistant Graph<br/>[main.py]"]
  node_intent["Intent Routing<br/>[main.py]"]
  node_policy_docs["Policy Documents"]
  node_vector_store[("Chroma Store<br/>[main.py]")]
  node_embedding["Query Embeddings<br/>[main.py]"]
  node_retrieval["Policy Retrieval<br/>[main.py]"]
  node_answer["Answer Validation<br/>[main.py]"]
  node_response["Answer Response<br/>[main.py]"]
end

node_operator(("Operator"))
node_book_site["Books To Scrape"]
node_titanic_source["Titanic Dataset"]
node_support_user(("Customer"))

node_operator -->|"runs"| node_pipeline
node_pipeline -->|"calls"| node_extract
node_extract -->|"fetches pages"| node_book_site
node_extract -->|"returns records"| node_clean
node_pipeline -->|"calls"| node_clean
node_pipeline -->|"calls"| node_load
node_clean -->|"provides rows"| node_load
node_load -->|"writes tables"| node_books_db
node_pipeline -->|"calls"| node_sql_analysis
node_sql_analysis -->|"queries"| node_books_db
node_pipeline -->|"runs"| node_join_check
node_join_check -->|"reads SQL join"| node_books_db
node_operator -->|"runs"| node_eda
node_titanic_source -->|"loads dataset"| node_eda
node_eda -->|"writes cleaned data"| node_clean_data
node_operator -->|"runs"| node_modeling
node_clean_data -->|"provides features"| node_modeling
node_modeling -->|"trains classifier"| node_survival
node_modeling -->|"trains regressor"| node_fare
node_modeling -->|"writes metrics"| node_metrics
node_support_user -->|"submits question"| node_api
node_api -->|"invokes"| node_agent
node_agent -->|"dispatches"| node_intent
node_agent -->|"loads documents"| node_policy_docs
node_agent -->|"bootstraps collection"| node_vector_store
node_intent -->|"routes policy queries"| node_retrieval
node_intent -->|"routes general queries"| node_response
node_retrieval -->|"encodes query"| node_embedding
node_retrieval -->|"queries"| node_vector_store
node_retrieval -->|"provides chunks"| node_answer
node_answer -->|"builds response"| node_response
node_api -->|"returns"| node_response

click node_pipeline "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_extract "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_clean "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_load "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_books_db "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/zepto_books.db"
click node_sql_analysis "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_join_check "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py"
click node_eda "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/01_eda.py"
click node_clean_data "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/01_eda.py"
click node_modeling "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py"
click node_survival "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py"
click node_fare "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py"
click node_metrics "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py"
click node_api "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_agent "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_intent "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_policy_docs "https://github.com/chowdary0507/zepto-ai-ml-capstone/tree/main/support_assistant/docs"
click node_vector_store "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_embedding "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_retrieval "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_answer "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py"
click node_response "https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.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_pipeline,node_extract,node_clean,node_load,node_books_db,node_sql_analysis,node_join_check toneBlue
class node_eda,node_clean_data,node_modeling,node_survival,node_fare,node_metrics toneAmber
class node_api,node_agent,node_intent,node_policy_docs,node_vector_store,node_embedding,node_retrieval,node_answer,node_response toneMint
class node_operator,node_book_site,node_titanic_source,node_support_user toneIndigo
```

## Components

### Book Data Pipeline

- [Pipeline Runner](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`
- [Book Extraction](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`
- [Price Conversion](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`
- [Relational Load](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`
- [Books SQLite](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/zepto_books.db): `data_pipeline/zepto_books.db`
- [SQL Queries](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`
- [Join Comparison](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/data_pipeline/pipeline.py): `data_pipeline/pipeline.py`

### Titanic Analytics

- [EDA and Cleaning](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/01_eda.py): `analytics/01_eda.py`
- [Cleaned Dataset](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/01_eda.py): `analytics/01_eda.py`
- [Model Training](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py): `analytics/02_modeling.py`
- [Survival Classifier](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py): `analytics/02_modeling.py`
- [Fare Regression](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py): `analytics/02_modeling.py`
- [Model Metrics](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/analytics/02_modeling.py): `analytics/02_modeling.py`

### Policy Assistant

- [Ask API](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Assistant Graph](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Intent Routing](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Policy Documents](https://github.com/chowdary0507/zepto-ai-ml-capstone/tree/main/support_assistant/docs): `support_assistant/docs`
- [Chroma Store](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Query Embeddings](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Policy Retrieval](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Answer Validation](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`
- [Answer Response](https://github.com/chowdary0507/zepto-ai-ml-capstone/blob/main/support_assistant/main.py): `support_assistant/main.py`

### Other components

- **Operator**
- **Books To Scrape**
- **Titanic Dataset**
- **Customer**

## Connections

- Operator → Pipeline Runner: runs
- Pipeline Runner → Book Extraction: calls
- Book Extraction → Books To Scrape: fetches pages
- Book Extraction → Price Conversion: returns records
- Pipeline Runner → Price Conversion: calls
- Pipeline Runner → Relational Load: calls
- Price Conversion → Relational Load: provides rows
- Relational Load → Books SQLite: writes tables
- Pipeline Runner → SQL Queries: calls
- SQL Queries → Books SQLite: queries
- Pipeline Runner → Join Comparison: runs
- Join Comparison → Books SQLite: reads SQL join
- Operator → EDA and Cleaning: runs
- Titanic Dataset → EDA and Cleaning: loads dataset
- EDA and Cleaning → Cleaned Dataset: writes cleaned data
- Operator → Model Training: runs
- Cleaned Dataset → Model Training: provides features
- Model Training → Survival Classifier: trains classifier
- Model Training → Fare Regression: trains regressor
- Model Training → Model Metrics: writes metrics
- Customer → Ask API: submits question
- Ask API → Assistant Graph: invokes
- Assistant Graph → Intent Routing: dispatches
- Assistant Graph → Policy Documents: loads documents
- Assistant Graph → Chroma Store: bootstraps collection
- Intent Routing → Policy Retrieval: routes policy queries
- Intent Routing → Answer Response: routes general queries
- Policy Retrieval → Query Embeddings: encodes query
- Policy Retrieval → Chroma Store: queries
- Policy Retrieval → Answer Validation: provides chunks
- Answer Validation → Answer Response: builds response
- Ask API → Answer Response: returns