# 1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications architecture

> Architecture diagram of the GitHub repository 1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications
- Repository: https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications

## Overview

##### Project type and purpose
- This is an educational monorepo: a “learning-path” that walks users from Python fundamentals to advanced Generative AI applications.
- It contains notebooks, example code, and mini-apps using Streamlit, FastAPI, Docker, Kafka, OpenAI APIs, etc.

##### File structure
- Top-level “layers” / directories:
– 00_AI_Essentials: pure concepts and theory
– 01_Python_basics_A_to_Z: Python intro using notebooks
– 02_streamlit: hands-on UI demos (hello-world → multi-page apps → state management)
– 03_everything_is_an_api: HTTP, Pydantic, serverless DB, pytest, FastAPI tutorials
– 04_microservices_all_in_one_platform: microservices theory + Poerty/FastAPI projects + Docker & Kafka labs
– 06_openai: direct OpenAI API notebooks (chat, functions, streaming, multimodal, fine-tune)
– 08_streamlit_genai_apps: end-to-end Streamlit GenAI mini-apps (single vs multi-user, assistant patterns)
– 09_streamlit_genai_projects: capstone projects (placeholder for real-world apps)
- Shared config files: README.md, LICENSE

##### README for additional insights
- It highlights two main API families (Chat Completions vs Assistants API) and OpenAI features
- Emphasizes progression from stateless prompts to stateful, tool-augmented agents

a. Main components (as modules/layers):
1. Fundamentals Layer
- 00_AI_Essentials
- 01_Python_basics_A_to_Z
2. UI/Frontend Layer
- 02_streamlit
3. API & Backend Layer
- 03_everything_is_an_api
- FastAPI, Pydantic, Postgres, pytest
4. Microservices & Infra Layer
- 04_microservices_all_in_one_platform
- Domain-driven design, Poetry, Docker, Docker-Compose, Kafka
5. OpenAI Core Layer
- 06_openai
- Chat Completions API, Assistants API, Streaming, Functions, Whisper, DALL·E, Embeddings
6. End-to-End App Layer
- 08_streamlit_genai_apps
- 09_streamlit_genai_projects
- Combines UI + OpenAI + persistence

b. Relationships & data flows
- UI Layer → API & Backend Layer (Streamlit apps call FastAPI or direct APIs)
- API & Backend → Microservices/Infra (shift from monolith demos to containerized microservices and event streams)
- Microservices/Infra → OpenAI Core (these services can integrate OpenAI features)
- OpenAI Core → End-to-End Apps (Streamlit GenAI apps sit on top of OpenAI services for chat, vision, TTS, etc.)

c. Architectural patterns & principles
- Layered architecture (learning progression)
- Separation of concerns: UI vs business logic vs infra
- Microservices pattern: domain services, containerization, orchestration
- API-first design: demos evolve from HTTP → FastAPI → multi-container
- Serverless & event-driven (Kafka labs)
- Stateful vs stateless patterns in OpenAI integration

d. Key technologies, frameworks, libraries
- Python, Jupyter Notebooks
- Streamlit (UI prototyping)
- Requests, Pydantic, SQLAlchemy/ORM, PostgreSQL
- FastAPI
- Poetry (packaging), Docker, Docker-Compose, DevContainers
- Kafka (event streaming)
- OpenAI APIs (Chat Completions, Assistants, Vision, Whisper, Embeddings)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Fundamentals Layer
    subgraph "Fundamentals Layer"
        F1["00_AI_Essentials"]:::fund
        F2_nb["Python Notebook"]:::fund
        F2_utils["Python Utils"]:::fund
    end

    %% UI/Frontend Layer
    subgraph "UI/Frontend Layer"
        U1["Streamlit Hello World"]:::ui
        U2["Multipage App"]:::ui
        U3["Session State Demo"]:::ui
    end

    %% API & Backend Layer
    subgraph "API & Backend Layer"
        A1["Requests Tutorials"]:::api
        A2["Pydantic Tutorial"]:::api
        A3["Serverless DB Demos"]:::api
        A4["Pytest Examples"]:::api
        A5["FastAPI Basics"]:::api
    end

    %% Microservices & Infra Layer
    subgraph "Microservices & Infra Layer"
        M1["Domain-Driven Design"]:::infra
        M2["Poetry Projects"]:::infra
        M3["Docker Labs"]:::infra
        M4["Event-Driven Kafka"]:::infra
    end

    %% OpenAI Core Layer
    subgraph "OpenAI Core Layer"
        O1["OpenAI Hello World"]:::openai
        O2["Function Calling"]:::openai
        O3["Assistants API"]:::openai
        O4["Multimodal GenAI"]:::openai
        O5["Fine-tuning"]:::openai
    end

    %% End-to-End App Layer
    subgraph "End-to-End App Layer"
        E1["Completion Chat App"]:::apps
        E2["Assistant Multi-User App"]:::apps
        E3["Capstone Projects"]:::apps
    end

    %% Connections
    F1 --> U1
    F2_nb --> U1
    F2_utils --> U2
    U1 --> A5
    U2 --> A5
    U3 --> A5
    A1 --> M2
    A2 --> M2
    A3 --> M2
    A4 --> M2
    A5 --> M3
    M1 --> M2
    M2 --> M3
    M3 --> M4
    M4 --> O1
    O1 --> E1
    O2 --> E1
    O3 --> E2
    O4 --> E2
    O5 --> E1
    O5 --> E2
    E1 --> E3
    E2 --> E3

    %% Click Events
    click F1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/00_AI_Essentials/Readme.md"
    click F2_nb "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/01_Python_basics_A_to_Z/01_A_smarter_way_to_learn_python.ipynb"
    click F2_utils "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/01_Python_basics_A_to_Z/utils.py"
    click U1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/02_streamlit/01_streamlit_hello_world/01_hello_world.py"
    click U2 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/02_streamlit/04_multipages_app/hello.py"
    click U3 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/02_streamlit/05_session_state/0_counter_without_session.py"
    click A1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/03_everything_is_an_api/01_requests/01_requests.ipynb"
    click A2 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/03_everything_is_an_api/02_pydantic/01_pydantic.ipynb"
    click A3 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/03_everything_is_an_api/03_serverless_postgresql_database/hello_world.ipynb"
    click A4 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/03_everything_is_an_api/04_pytest/calculator.py"
    click A5 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/03_everything_is_an_api/07_fastapi/01_fastapi_hello_basics/main.py"
    click M1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/04_microservices_all_in_one_platform/06_domain_driven_design/readme.md"
    click M2 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/04_microservices_all_in_one_platform/10_poetry_project/farhan_poetry_project/pyproject.toml"
    click M3 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/tree/main/04_microservices_all_in_one_platform/11_docker/01_containerizing_poetry/Dockerfile"
    click M4 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/04_microservices_all_in_one_platform/12_even_driven_kafka/01_eda_challenge/readme.md"
    click O1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/06_openai/01_hello_world/openai_hello_world.ipynb"
    click O2 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/06_openai/05_function_calling/01_function_calling.ipynb"
    click O3 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/06_openai/06_assistants api/01_assistants_api.ipynb"
    click O4 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/06_openai/10_multimodal_gen_ai/text_to_speech.ipynb"
    click O5 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/06_openai/11_finetune/01_fine_tune.ipynb"
    click E1 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/08_streamlit_genai_apps/01_completion_chat_app/01_single_user/app.py"
    click E2 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/08_streamlit_genai_apps/02_assistant_app/02_multi_user/app.py"
    click E3 "https://github.com/1muhammadfarhanaslam/generative-ai-learning-path-from-fundamentals-to-advanced-applications/blob/main/09_streamlit_genai_projects/readme.md"

    %% Styles
    classDef fund fill:#AED6F1,stroke:#21618C,color:#000;
    classDef ui fill:#A9DFBF,stroke:#196F3D,color:#000;
    classDef api fill:#FAD7A0,stroke:#BF8F00,color:#000;
    classDef infra fill:#D2B4DE,stroke:#6C3483,color:#000;
    classDef openai fill:#76D7C4,stroke:#117A65,color:#000;
    classDef apps fill:#F5B7B1,stroke:#922B21,color:#000;
```
