# ibrahimbagislar/chefgpt architecture

> Architecture diagram of the GitHub repository ibrahimbagislar/chefgpt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ibrahimbagislar/chefgpt
- Repository: https://github.com/ibrahimbagislar/chefgpt

## Overview

ChefGPT combines recipe-data acquisition and preparation, model training, and a local FAISS/Ollama RAG assistant with a web interface. The documented data workflow runs from scraping through Q&A generation and training, while the runtime workflow retrieves recipe context before generating an answer. Some stages are documented but their implementations were not sampled; those relationships are cited to the README, and the web backend is not present in the repository.

Main entry points: [`scraper/Program.cs`](https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/Program.cs) (Recipe scraper), [`local/build_faiss.py`](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/build_faiss.py) (FAISS index builder), [`local/chefgpt_server_faiss.py`](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py) (RAG server), [`scraper/QAGenerator.cs`](https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/QAGenerator.cs) (Q&A generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Recipe collection"]
  node_scraper["Recipe scraper<br/>[Program.cs]"]
  node_recipe_csv["Recipe CSV"]
end

subgraph group_preparation["Data preparation"]
  node_qa_generator["Q&amp;A generator<br/>[QAGenerator.cs]"]
  node_qa_dataset["Q&amp;A dataset"]
end

subgraph group_training["Model training"]
  node_trainer["Model fine-tuning"]
  node_gguf_model["GGUF model"]
end

subgraph group_runtime["Local RAG runtime"]
  node_index_builder["FAISS index builder<br/>[build_faiss.py]"]
  node_embedding_model["Sentence embeddings<br/>[build_faiss.py]"]
  node_faiss_index[("FAISS index")]
  node_recipe_metadata["Recipe metadata"]
  node_rag_server["RAG server"]
  node_retrieval["Recipe retrieval"]
  node_context_prompt["Context prompting"]
end

subgraph group_interface["Web interface"]
  node_web_app["Chat interface<br/>[app.js]"]
end

node_user(("User"))
node_recipe_site["Recipe source"]
node_ollama["Ollama service"]
node_api_backend["Chat API backend"]

node_user -->|"requests recipes"| node_scraper
node_scraper -->|"fetches pages"| node_recipe_site
node_scraper -->|"writes recipes"| node_recipe_csv
node_scraper -->|"invokes Q&amp;A mode"| node_qa_generator
node_qa_generator -->|"reads recipes"| node_recipe_csv
node_qa_generator -->|"generates pairs"| node_qa_dataset
node_qa_dataset -->|"trains on data"| node_trainer
node_trainer -->|"exports model"| node_gguf_model
node_gguf_model -->|"runs locally"| node_ollama
node_recipe_csv -->|"provides recipes"| node_index_builder
node_index_builder -->|"encodes recipes"| node_embedding_model
node_index_builder -->|"writes vectors"| node_faiss_index
node_index_builder -->|"writes metadata"| node_recipe_metadata
node_faiss_index -->|"loads index"| node_rag_server
node_recipe_metadata -->|"loads metadata"| node_rag_server
node_rag_server -->|"runs search"| node_retrieval
node_retrieval -->|"builds context"| node_context_prompt
node_context_prompt -->|"requests completion"| node_ollama
node_user -->|"asks question"| node_web_app
node_web_app -->|"posts chat"| node_api_backend
node_api_backend -.->|"forwards request"| node_rag_server
node_api_backend -->|"streams response"| node_web_app

click node_scraper "https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/Program.cs"
click node_qa_generator "https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/QAGenerator.cs"
click node_trainer "https://github.com/ibrahimbagislar/chefgpt/blob/main/training/ChefGPTModelEgitim.ipynb"
click node_index_builder "https://github.com/ibrahimbagislar/chefgpt/blob/main/local/build_faiss.py"
click node_embedding_model "https://github.com/ibrahimbagislar/chefgpt/blob/main/local/build_faiss.py"
click node_rag_server "https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py"
click node_retrieval "https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py"
click node_context_prompt "https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py"
click node_web_app "https://github.com/ibrahimbagislar/chefgpt/blob/main/website/app.js"

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_scraper,node_recipe_csv,node_user toneBlue
class node_qa_generator,node_qa_dataset toneAmber
class node_trainer,node_gguf_model,node_api_backend toneMint
class node_index_builder,node_embedding_model,node_faiss_index,node_recipe_metadata,node_rag_server,node_retrieval,node_context_prompt toneRose
class node_web_app,node_recipe_site,node_ollama toneIndigo
```

## Components

### Recipe collection

- [Recipe scraper](https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/Program.cs): `scraper/Program.cs`
- **Recipe CSV**

### Data preparation

- [Q&A generator](https://github.com/ibrahimbagislar/chefgpt/blob/main/scraper/QAGenerator.cs): `scraper/QAGenerator.cs`
- **Q&A dataset**

### Model training

- [Model fine-tuning](https://github.com/ibrahimbagislar/chefgpt/blob/main/training/ChefGPTModelEgitim.ipynb): `training/ChefGPTModelEgitim.ipynb`
- **GGUF model**

### Local RAG runtime

- [FAISS index builder](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/build_faiss.py): `local/build_faiss.py`
- [Sentence embeddings](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/build_faiss.py): `local/build_faiss.py`
- **FAISS index**
- **Recipe metadata**
- [RAG server](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py): `local/chefgpt_server_faiss.py`
- [Recipe retrieval](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py): `local/chefgpt_server_faiss.py`
- [Context prompting](https://github.com/ibrahimbagislar/chefgpt/blob/main/local/chefgpt_server_faiss.py): `local/chefgpt_server_faiss.py`

### Web interface

- [Chat interface](https://github.com/ibrahimbagislar/chefgpt/blob/main/website/app.js): `website/app.js`

### Other components

- **User**
- **Recipe source**
- **Ollama service**
- **Chat API backend**

## Connections

- User → Recipe scraper: requests recipes (evidence: `README.md`)
- Recipe scraper → Recipe source: fetches pages (evidence: `scraper/Program.cs`)
- Recipe scraper → Recipe CSV: writes recipes (evidence: `README.md`)
- Recipe scraper → Q&A generator: invokes Q&A mode (evidence: `scraper/Program.cs`)
- Q&A generator → Recipe CSV: reads recipes (evidence: `README.md`)
- Q&A generator → Q&A dataset: generates pairs (evidence: `README.md`)
- Q&A dataset → Model fine-tuning: trains on data (evidence: `README.md`)
- Model fine-tuning → GGUF model: exports model (evidence: `README.md`)
- GGUF model → Ollama service: runs locally (evidence: `README.md`)
- Recipe CSV → FAISS index builder: provides recipes (evidence: `README.md`)
- FAISS index builder → Sentence embeddings: encodes recipes (evidence: `local/build_faiss.py`)
- FAISS index builder → FAISS index: writes vectors (evidence: `local/build_faiss.py`)
- FAISS index builder → Recipe metadata: writes metadata (evidence: `local/build_faiss.py`)
- FAISS index → RAG server: loads index (evidence: `local/chefgpt_server_faiss.py`)
- Recipe metadata → RAG server: loads metadata (evidence: `local/chefgpt_server_faiss.py`)
- RAG server → Recipe retrieval: runs search (evidence: `local/chefgpt_server_faiss.py`)
- Recipe retrieval → Context prompting: builds context (evidence: `local/chefgpt_server_faiss.py`)
- Context prompting → Ollama service: requests completion (evidence: `local/chefgpt_server_faiss.py`)
- User → Chat interface: asks question (evidence: `README.md`)
- Chat interface → Chat API backend: posts chat (evidence: `website/app.js`)
- Chat API backend → RAG server: forwards request
- Chat API backend → Chat interface: streams response (evidence: `website/app.js`)
