# nuriveben/generative_ai_temp architecture

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

- Interactive diagram: https://gitdiagram.com/nuriveben/generative_ai_temp
- Repository: https://github.com/nuriveben/generative_ai_temp

## Overview

This repository is a Generative AI application template, not a single finished product. Its documented capabilities cover chat and document pipelines, agents, LLM providers and prompt engineering, memory and retrieval, skills and multimodal processing, plus safety and operational utilities. The README describes these as organized modules but does not specify a concrete user-to-result call sequence. The sampled source excerpts are empty, so the graph preserves the documented subsystems without inventing runtime connections.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Pipelines and Agents"]
  node_chat_flow["Chat Flow<br/>[chat_flow.py]"]
  node_doc_processor["Document Processing<br/>[doc_processor.py]"]
  node_base_agent["Base Agent<br/>[base_agent.py]"]
  node_planner["Agent Planner<br/>[planner.py]"]
  node_executor["Agent Executor<br/>[executor.py]"]
end

subgraph group_models["LLM and Prompts"]
  node_llm_router["LLM Router<br/>[router.py]"]
  node_openai["OpenAI Adapter<br/>[openai.py]"]
  node_anthropic["Anthropic Adapter<br/>[anthropic.py]"]
  node_llm_schemas["LLM Schemas<br/>[schemas.py]"]
  node_prompt_chainer["Prompt Chaining<br/>[chainer.py]"]
  node_prompt_templates["Prompt Templates<br/>[templates.py]"]
  node_few_shot["Few-Shot Prompts<br/>[few_shot.py]"]
end

subgraph group_knowledge["Memory and Retrieval"]
  node_short_memory["Short-Term Memory<br/>[short_term.py]"]
  node_long_memory["Long-Term Memory<br/>[long_term.py]"]
  node_document_db[("Document Lookup<br/>[document_db.py]")]
  node_vector_db[("Vector Search<br/>[vector_db.py]")]
end

subgraph group_capabilities["Skills and Multimodal"]
  node_web_search["Web Search<br/>[web_search.py]"]
  node_code_interpreter["Code Interpreter"]
  node_image_processor["Image Processing<br/>[image_processor.py]"]
  node_speech_handler["Speech Handling<br/>[speech_handler.py]"]
end

subgraph group_safety["Safety and Operations"]
  node_fallback_router["Fallback Routing<br/>[router.py]"]
  node_pii_guard["PII Guardrails<br/>[pii.py]"]
  node_error_handler["Error Handling<br/>[error_handler.py]"]
  node_utilities["Runtime Utilities"]
end

node_configuration["Runtime Configuration"]

click node_chat_flow "https://github.com/nuriveben/generative_ai_temp/blob/main/src/pipelines/chat_flow.py"
click node_doc_processor "https://github.com/nuriveben/generative_ai_temp/blob/main/src/pipelines/doc_processor.py"
click node_base_agent "https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/base_agent.py"
click node_planner "https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/planner.py"
click node_executor "https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/executor.py"
click node_llm_router "https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/router.py"
click node_openai "https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/platforms/openai.py"
click node_anthropic "https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/platforms/anthropic.py"
click node_llm_schemas "https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/schemas.py"
click node_prompt_chainer "https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/chainer.py"
click node_prompt_templates "https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/templates.py"
click node_few_shot "https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/few_shot.py"
click node_short_memory "https://github.com/nuriveben/generative_ai_temp/blob/main/src/memory/short_term.py"
click node_long_memory "https://github.com/nuriveben/generative_ai_temp/blob/main/src/memory/long_term.py"
click node_document_db "https://github.com/nuriveben/generative_ai_temp/blob/main/src/retrieval/document_db.py"
click node_vector_db "https://github.com/nuriveben/generative_ai_temp/blob/main/src/retrieval/vector_db.py"
click node_web_search "https://github.com/nuriveben/generative_ai_temp/blob/main/src/skills/web_search.py"
click node_code_interpreter "https://github.com/nuriveben/generative_ai_temp/blob/main/src/skills/code_interpreter.py"
click node_image_processor "https://github.com/nuriveben/generative_ai_temp/blob/main/src/vision_audio/image_processor.py"
click node_speech_handler "https://github.com/nuriveben/generative_ai_temp/blob/main/src/vision_audio/speech_handler.py"
click node_fallback_router "https://github.com/nuriveben/generative_ai_temp/blob/main/src/fallback/router.py"
click node_pii_guard "https://github.com/nuriveben/generative_ai_temp/blob/main/src/guardrails/pii.py"
click node_error_handler "https://github.com/nuriveben/generative_ai_temp/blob/main/src/handlers/error_handler.py"
click node_utilities "https://github.com/nuriveben/generative_ai_temp/tree/main/src/utils"
click node_configuration "https://github.com/nuriveben/generative_ai_temp/tree/main/config"

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_chat_flow,node_doc_processor,node_base_agent,node_planner,node_executor toneBlue
class node_llm_router,node_openai,node_anthropic,node_llm_schemas,node_prompt_chainer,node_prompt_templates,node_few_shot toneAmber
class node_short_memory,node_long_memory,node_document_db,node_vector_db toneMint
class node_web_search,node_code_interpreter,node_image_processor,node_speech_handler toneRose
class node_fallback_router,node_pii_guard,node_error_handler,node_utilities toneIndigo
class node_configuration toneTeal
```

## Components

### Pipelines and Agents

- [Chat Flow](https://github.com/nuriveben/generative_ai_temp/blob/main/src/pipelines/chat_flow.py): `src/pipelines/chat_flow.py`
- [Document Processing](https://github.com/nuriveben/generative_ai_temp/blob/main/src/pipelines/doc_processor.py): `src/pipelines/doc_processor.py`
- [Base Agent](https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/base_agent.py): `src/agents/base_agent.py`
- [Agent Planner](https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/planner.py): `src/agents/planner.py`
- [Agent Executor](https://github.com/nuriveben/generative_ai_temp/blob/main/src/agents/executor.py): `src/agents/executor.py`

### LLM and Prompts

- [LLM Router](https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/router.py): `src/llm/router.py`
- [OpenAI Adapter](https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/platforms/openai.py): `src/llm/platforms/openai.py`
- [Anthropic Adapter](https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/platforms/anthropic.py): `src/llm/platforms/anthropic.py`
- [LLM Schemas](https://github.com/nuriveben/generative_ai_temp/blob/main/src/llm/schemas.py): `src/llm/schemas.py`
- [Prompt Chaining](https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/chainer.py): `src/prompt_engineering/chainer.py`
- [Prompt Templates](https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/templates.py): `src/prompt_engineering/templates.py`
- [Few-Shot Prompts](https://github.com/nuriveben/generative_ai_temp/blob/main/src/prompt_engineering/few_shot.py): `src/prompt_engineering/few_shot.py`

### Memory and Retrieval

- [Short-Term Memory](https://github.com/nuriveben/generative_ai_temp/blob/main/src/memory/short_term.py): `src/memory/short_term.py`
- [Long-Term Memory](https://github.com/nuriveben/generative_ai_temp/blob/main/src/memory/long_term.py): `src/memory/long_term.py`
- [Document Lookup](https://github.com/nuriveben/generative_ai_temp/blob/main/src/retrieval/document_db.py): `src/retrieval/document_db.py`
- [Vector Search](https://github.com/nuriveben/generative_ai_temp/blob/main/src/retrieval/vector_db.py): `src/retrieval/vector_db.py`

### Skills and Multimodal

- [Web Search](https://github.com/nuriveben/generative_ai_temp/blob/main/src/skills/web_search.py): `src/skills/web_search.py`
- [Code Interpreter](https://github.com/nuriveben/generative_ai_temp/blob/main/src/skills/code_interpreter.py): `src/skills/code_interpreter.py`
- [Image Processing](https://github.com/nuriveben/generative_ai_temp/blob/main/src/vision_audio/image_processor.py): `src/vision_audio/image_processor.py`
- [Speech Handling](https://github.com/nuriveben/generative_ai_temp/blob/main/src/vision_audio/speech_handler.py): `src/vision_audio/speech_handler.py`

### Safety and Operations

- [Fallback Routing](https://github.com/nuriveben/generative_ai_temp/blob/main/src/fallback/router.py): `src/fallback/router.py`
- [PII Guardrails](https://github.com/nuriveben/generative_ai_temp/blob/main/src/guardrails/pii.py): `src/guardrails/pii.py`
- [Error Handling](https://github.com/nuriveben/generative_ai_temp/blob/main/src/handlers/error_handler.py): `src/handlers/error_handler.py`
- [Runtime Utilities](https://github.com/nuriveben/generative_ai_temp/tree/main/src/utils): `src/utils`

### Other components

- [Runtime Configuration](https://github.com/nuriveben/generative_ai_temp/tree/main/config): `config`
