# aniket-work/lets-build-solution-architect-ai-agent architecture

> Architecture diagram of the GitHub repository aniket-work/lets-build-solution-architect-ai-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aniket-work/lets-build-solution-architect-ai-agent
- Repository: https://github.com/aniket-work/lets-build-solution-architect-ai-agent

## Overview

##### Project Type and Purpose
- This is a full-stack AI-powered “Solution Architect” tool built in Python.

##### File Structure Analysis
- Top-level files:
- main.py (Streamlit entry point)
- sandbox.py (ad hoc testing)
- requirements.txt, .env.local, config folder
- Directories:
- ui/ – Streamlit components (dashboard, styling, reusable widgets)
- core/ – Agent orchestration (architect_agent.py) and engine logic (engine.py)
- services/ – Two service layers:
– model_service.py (calls Groq API + LLM inference)
- utils/ – Helpers: parser, logger configuration
- config/ – JSON/YAML settings for models, endpoints, formatting

##### README Insights
- Modular design: UI, core engine, services, utilities.

##### Main Components and Their Relationships
a. Frontend Layer (ui/)
- Dashboard entrypoint (main.py → ui/dashboard.py)
- Styling (ui/styling.py, custom CSS)
- Components (ui/components.py)
b. Core Engine (core/)
- engine.py – abstract engine for sequencing tools and reasoning
c. Service Layer (services/)
d. Utility Layer (utils/)
- logger_config.py – sets up Python logging across modules
e. Configuration (config/)
- defaults.json, settings.yaml – endpoints, model names, thresholds, styling defaults
f. External Services
- Groq API (LLM inference)
- Optional DuckDuckGo search tool for research steps

##### Data Flow and Interactions
1. User enters requirements in Streamlit UI.
2. UI passes text to core.architect_agent.
3. architect_agent uses engine.py to plan sub-tasks (e.g., “generate component list”, “draft relationships”).
4. model_service calls Groq/Llama to fulfill each sub-task.
6. utils.diagram_parser validates/fixes syntax.
8. All steps logged via utils.logger_config.

##### Architectural Patterns and Principles
- Modular separation of concerns (UI vs. business logic vs. services vs. utils)
- Agent pattern (Agno framework) for multi-step reasoning
- Configuration-driven behavior via JSON/YAML

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        main["main.py\n(Streamlit Entry)"]:::frontend
        Dashboard["ui/dashboard.py\n(UI Dashboard)"]:::frontend
        Styling["ui/styling.py\n(UI Styling)"]:::frontend
        Components["ui/components.py\n(Reusable Widgets)"]:::frontend
        Renderer["Streamlit-Mermaid\nRenderer"]:::frontend
    end

    %% Core Engine Layer
    subgraph "Core Engine"
        ArchitectAgent["core/architect_agent.py\n(Agent Orchestration)"]:::core
        Engine["core/engine.py\n(Sequencer)"]:::core
    end

    %% Service Layer
    subgraph "Service Layer"
        ModelService["services/model_service.py\n(LLM Calls)"]:::service
        DiagramService["services/diagram_service.py\n(Mermaid Generation)"]:::service
    end

    %% Utility Layer
    subgraph "Utility Layer"
        Parser["utils/diagram_parser.py\n(Parser/Validator)"]:::util
        Logger["utils/logger_config.py\n(Logging)"]:::util
    end

    %% Configuration Layer
    subgraph "Configuration"
        Defaults["config/defaults.json"]:::config
        Settings["config/settings.yaml"]:::config
    end

    %% External Services
    subgraph "External Services"
        GroqAPI["Groq API\n(LLM Inference)"]:::external
        Duck["DuckDuckGo Search"]:::external
    end

    %% Miscellaneous
    subgraph "Miscellaneous"
        Sandbox["sandbox.py\n(Testing Sandbox)"]:::util
        DesignDocs["design_docs/\n(Static References)"]:::util
    end

    %% Flow Connections
    main -->|enters requirements| Dashboard
    Dashboard -->|calls| ArchitectAgent
    ArchitectAgent -->|plans tasks| Engine
    Engine -->|prompts| ModelService
    ModelService -->|sends text| GroqAPI
    GroqAPI -->|response| ModelService
    ModelService -->|raw output| DiagramService
    DiagramService -->|mermaid code| Parser
    Parser -->|validated code| Renderer
    Renderer -->|renders| Dashboard

    %% Optional research step
    ArchitectAgent -->|research| Duck

    %% Configuration lookup (dashed)
    Defaults -.-> main
    Defaults -.-> Dashboard
    Defaults -.-> ArchitectAgent
    Defaults -.-> Engine
    Defaults -.-> ModelService
    Defaults -.-> DiagramService
    Defaults -.-> Parser
    Defaults -.-> Logger
    Settings -.-> main
    Settings -.-> Dashboard
    Settings -.-> ArchitectAgent
    Settings -.-> Engine
    Settings -.-> ModelService
    Settings -.-> DiagramService
    Settings -.-> Parser
    Settings -.-> Logger

    %% Click Events
    click main "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/main.py"
    click Dashboard "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/ui/dashboard.py"
    click Styling "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/ui/styling.py"
    click Components "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/ui/components.py"
    click ArchitectAgent "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/core/architect_agent.py"
    click Engine "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/core/engine.py"
    click ModelService "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/services/model_service.py"
    click DiagramService "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/services/diagram_service.py"
    click Parser "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/utils/diagram_parser.py"
    click Logger "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/utils/logger_config.py"
    click Defaults "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/config/defaults.json"
    click Settings "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/config/settings.yaml"
    click Sandbox "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/blob/main/sandbox.py"
    click DesignDocs "https://github.com/aniket-work/lets-build-solution-architect-ai-agent/tree/main/design_docs/"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#00529B;
    classDef core fill:#d0f0c0,stroke:#4F8A10;
    classDef service fill:#fef2c0,stroke:#9F6000;
    classDef util fill:#e0e0e0,stroke:#666666;
    classDef config fill:#ffd1d1,stroke:#D8000C,stroke-dasharray: 5 5;
    classDef external fill:#ffe6e6,stroke:#A32424,stroke-dasharray: 5 5;
```
