# shivan118/ai-powered-fitness-coach-with-personalized-workouts architecture

> Architecture diagram of the GitHub repository shivan118/ai-powered-fitness-coach-with-personalized-workouts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts
- Repository: https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts

## Overview

##### Project type and purpose
- This is a Python-based, single-page web application (full-stack monolith) that serves as an AI-powered fitness coach.
- The frontend UI is built with Streamlit; the backend contains business logic for generating workout plans via LangChain & the OpenAI API.

##### File structure
- Top-level files:
– app.py        → Streamlit entry point (UI + routing)
– workout_generate.py → Core “service” that builds prompts and processes AI responses
– logger.py     → Central logging utility for events & errors
– main.py       → (Optional) script entry or orchestration (could wire modules)
– test.py/test2.py → Unit/integration tests for modules
– requirements.txt → Dependency manifest (Streamlit, LangChain, OpenAI, PDF libs, etc.)
- No separate “frontend/” and “backend/” folders; everything lives at root but naturally splits into:
– Presentation layer (app.py + Streamlit UI components)
– Business layer (workout_generate.py + LangChain integration)
– Infrastructure/utilities (logger.py, PDF export, session history in Streamlit)
– External dependencies (OpenAI API)
– Tests

##### README for additional insights
- Data flow is explicitly described: user input → workout generator → LangChain → OpenAI → UI → optional PDF download → session history.
- Technologies: Python 3.10, Streamlit, LangChain, OpenAI API.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Personas
    User["User"]:::external

    subgraph "Presentation Layer"
        App["app.py\nStreamlit UI"]:::presentation
        Main["main.py\nEntry Point"]:::presentation
    end

    subgraph "Business Logic & AI Layer"
        Generator["workout_generate.py\nWorkout Generator"]:::business
        PDF["PDF Generation Service (Optional)"]:::business
    end

    subgraph "AI Framework"
        LangChain["LangChain Framework"]:::external
        ExternalApi["OpenAI API"]:::external
    end

    subgraph "Utilities & Storage"
        Logger["logger.py\nLogging Utility"]:::infra
        SessionStore["Session Store\n(Streamlit session_state)"]:::infra
        Requirements["requirements.txt"]:::infra
    end

    subgraph "Documentation & Tests"
        Tests["Tests\n(test.py, test2.py)"]:::infra
        Arch["Architecture Diagram\n(Arch/arch.png)"]:::infra
        README["README.md"]:::infra
    end

    %% Data Flow
    User -->|"1. User Input"| App
    App -->|"2. Call Generator"| Generator
    Generator -->|"3. Invoke LangChain"| LangChain
    LangChain -->|"4. Call OpenAI API"| ExternalApi
    ExternalApi -->|"5. Return Response"| LangChain
    LangChain -->|"5b. Process Response"| Generator
    Generator -->|"6. Return Plan"| App
    App -->|"Optional PDF Export"| PDF
    App <-->|"Session History"| SessionStore
    Generator <-->|"Session Usage"| SessionStore

    %% Logging Relationships
    App -.->|"logs events"| Logger
    Generator -.->|"logs events"| Logger
    LangChain -.->|"logs events"| Logger
    ExternalApi -.->|"logs events"| Logger
    PDF -.->|"logs events"| Logger

    %% Click Events
    click App "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/app.py"
    click Main "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/main.py"
    click Generator "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/workout_generate.py"
    click Logger "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/logger.py"
    click Requirements "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/requirements.txt"
    click Tests "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/test.py"
    click Arch "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/Arch/arch.png"
    click README "https://github.com/shivan118/ai-powered-fitness-coach-with-personalized-workouts/blob/main/README.md"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef business fill:#98FB98,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef infra fill:#D3D3D3,stroke:#000,stroke-width:1px
```
