# jorschul/catalyst_center_genai_ops architecture

> Architecture diagram of the GitHub repository jorschul/catalyst_center_genai_ops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jorschul/catalyst_center_genai_ops
- Repository: https://github.com/jorschul/catalyst_center_genai_ops

## Overview

##### Project type and purpose
- This is a lightweight, CLI-based “network assistant” tool that leverages an LLM (OpenAI or other) to parse natural-language requests and trigger existing CI/CD pipelines (Jenkins jobs running Python/Ansible/Terraform) for Cisco DNA Center network automation.

##### File structure
- Top-level files only:
- catalyst_center_genai_config_tools.py – the main Python application
- requirements.txt – Python dependencies (OpenAI SDK, Cisco DNA Center SDK, requests, etc.)
- README.md + docs/metadata files (license, code of conduct)
- No separate frontend/backend folders: all logic lives in a single script that coordinates user I/O, calls the LLM, then dispatches functions.

##### README for additional insights
- Describes function-calling approach: user input → LLM → structured JSON response with “workflow name” and “params” → Python code invokes Jenkins REST API to launch jobs.
- Mentions reuse of existing IaC workflows (Python, Ansible, Terraform) and the Cisco DNA Center Python SDK for any direct DNA Center interactions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User (CLI)"]:::frontend

    subgraph "CLI Application"
        direction TB
        IO["User I/O Module"]:::orchestration
        LLM["LLM Integration Module"]:::orchestration
        Dispatch["Function Dispatch Module"]:::orchestration
        JenkinsClient["Jenkins REST API Client"]:::orchestration
        DNAClient["Cisco DNA Center SDK Client"]:::orchestration
    end

    subgraph "Project Files"
        direction TB
        Script["catalyst_center_genai_config_tools.py"]:::orchestration
        Req["requirements.txt"]:::orchestration
        Readme["README.md"]:::orchestration
        Contrib["CONTRIBUTING.md"]:::orchestration
        CoC["CODE_OF_CONDUCT.md"]:::orchestration
        License["LICENSE"]:::orchestration
        Notice["NOTICE"]:::orchestration
    end

    OpenAI["OpenAI LLM Endpoint"]:::external
    Jenkins["Jenkins Server"]:::external
    DNACenter["Cisco DNA Center"]:::external
    Devices["Network Devices"]:::external

    User -->|"Enter natural-language command"| IO
    IO -->|"Send prompt"| LLM
    LLM -->|"JSON function call"| Dispatch
    Dispatch -->|"Invoke local function"| JenkinsClient
    Dispatch -->|"Invoke optional direct workflow"| DNAClient
    JenkinsClient -->|"Start Jenkins job via REST"| Jenkins
    DNAClient -->|"Direct SDK calls"| DNACenter
    Jenkins -->|"Runs IaC pipelines"| DNACenter
    Jenkins -->|"Runs IaC pipelines"| Devices
    DNACenter -->|"Manages network devices"| Devices
    Jenkins -->|"Job status/pipeline URL"| IO

    click Script "https://github.com/jorschul/catalyst_center_genai_ops/blob/main/catalyst_center_genai_config_tools.py"
    click Req "https://github.com/jorschul/catalyst_center_genai_ops/blob/main/requirements.txt"
    click Readme "https://github.com/jorschul/catalyst_center_genai_ops/blob/main/README.md"
    click Contrib "https://github.com/jorschul/catalyst_center_genai_ops/blob/main/CONTRIBUTING.md"
    click CoC "https://github.com/jorschul/catalyst_center_genai_ops/blob/main/CODE_OF_CONDUCT.md"
    click License "https://github.com/jorschul/catalyst_center_genai_ops/tree/main/LICENSE"
    click Notice "https://github.com/jorschul/catalyst_center_genai_ops/tree/main/NOTICE"

    classDef frontend fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef orchestration fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef external fill:#ffe0b3,stroke:#333,stroke-width:1px
```
