# sekju/video-analyzer architecture

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

- Interactive diagram: https://gitdiagram.com/sekju/video-analyzer
- Repository: https://github.com/sekju/video-analyzer

## Overview

1 Identyfikacja projektu i celu
- Narzędzie do analizy wideo łączenie kluczowych klatek modelami wizji Llama oraz transkrypcja audio modelem Whisper
- Dostępne wersje  konsolowa i webowa

2 Analiza struktury plików
- folder video_analyzer z rdzeniem logiki
- podfolder clients z integracjami OpenAI i Ollama
- pliki analyzer audio_processor frame prompt config
- skrypt CLI video_analyzer/cli.py
- folder video-analyzer-ui z serwerem Flask i szablonami html css js

3 Główne komponenty diagramu
- Komponent ekstrakcji klatek  biblioteka OpenCV  element audio FFmpeg i Whisper
- Komponent analizy klatek  moduł analyzer z promptami frame_analysis
- Warstwa konfiguracji  hierarchy config default command line
- Komponent CLI  video-analyzer uruchamiający proces
- Serwer UI  Flask server.py  interfejs webowy
- Moduły klienckie  openai_api  ollama  abstrakcja klienta LLM
- Zewnętrzne usługi  lokalny Ollama  openrouter lub OpenAI API
- Warstwa wyjścia  JSON wyników

4 Relacje i przepływy danych
- strzałka z CLI lub UI do ekstrakcji klatek
- strzałka do audio_processor i whisper
- wynik przesyłany do analyzer z kontekstem poprzednich klatek i promptami
- analyzer wywołuje klienta LLM
- strzałka do zewnętrznych usług LLM
- analiza łączona z transkryptem
- ostateczna odpowiedź zapisywana w pliku JSON i zwracana do UI lub konsoli

5 Wzorce i zasady
- Wyraźny podział warstw  ekstrakcja audio i wideo  logika analizy  prezentacja
- Abstrakcja klienta LLM pozwala na łatwą wymianę między Ollama i OpenAI
- Hierarchia konfiguracji priorytet  CLI  user config  default

6 Wytyczne do rysowania diagramu
- Każdy komponent jako prostokąt z czytelną etykietą
- Kierunkowe strzałki pokazujące przepływ danych
- Użycie kolorów do odróżnienia warstw  na przykład zielony ekstrakcja  żółty analiza  niebieski klienci LLM  pomarańczowy UI
- Legenda opisująca znaczenie kolorów i strzałek
- Minimalna ilość nawiasów i znaków specjalnych by uniknąć błędów parsowania

7 Dopasowanie do projektu
- Dla części konsolowej skupienie na CLI i module core
- Dla części webowej  warstwa serwera Flask  statyczne zasoby i szablony
- Zaznaczenie punktów konfigurowalnych plik config default_config json i opcje CLI

Powyższe kroki umożliwią narysowanie czytelnego i dokładnego diagramu systemowego odzwierciedlającego architekturę projektu video-analyzer

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Wejście"
        CLI["CLI video-analyzer"]:::cli
        UI["Flask UI"]:::ui
    end
    CLI -->|"uruchamia ekstrakcję"| FrameExt
    UI -->|"uruchamia ekstrakcję"| FrameExt

    subgraph "Ekstrakcja"
        FrameExt["Ekstrakcja klatek"]:::extraction
        AudioProc["Ekstrakcja audio"]:::extraction
        WH["Transkrypcja Whisper"]:::extraction
    end
    FrameExt -->|"klatki"| Analyzer
    AudioProc -->|"audio"| WH
    WH --> Analyzer

    subgraph "Analiza"
        Analyzer["Analiza klatek"]:::analysis
    end

    subgraph "Prompts"
        PromptLoad["Ładowanie promptów"]:::config
        FramePr["frame_analysis.txt"]:::config
        DescPr["describe.txt"]:::config
    end
    Analyzer --> PromptLoad
    PromptLoad --> FramePr
    PromptLoad --> DescPr

    subgraph "Konfiguracja"
        ConfigLoad["Ładowanie konfiguracji"]:::config
        DefaultCfg["default_config.json"]:::config
    end
    CLI --> ConfigLoad
    UI --> ConfigLoad
    Analyzer --> ConfigLoad
    ConfigLoad --> DefaultCfg

    subgraph "LLM Clients"
        LLMClient["Abstrakcja LLM"]:::llm
        OA["OpenAI Client"]:::llm
        OM["Ollama Client"]:::llm
    end
    Analyzer -->|"wywołanie LLM"| LLMClient
    LLMClient --> OA
    LLMClient --> OM

    subgraph "Zewnętrzne usługi"
        OAAPI["OpenAI API"]:::external
        OllamaServ["Local Ollama"]:::external
    end
    OA --> OAAPI
    OM --> OllamaServ

    subgraph "Wyjście"
        Json["Plik JSON"]:::output
    end
    Analyzer --> Json
    Json --> CLI
    Json --> UI

    %% Click events
    click FrameExt "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/frame.py"
    click AudioProc "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/audio_processor.py"
    click Analyzer "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/analyzer.py"
    click PromptLoad "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/prompt.py"
    click FramePr "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/prompts/frame_analysis/frame_analysis.txt"
    click DescPr "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/prompts/frame_analysis/describe.txt"
    click ConfigLoad "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/config.py"
    click DefaultCfg "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/config/default_config.json"
    click CLI "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/cli.py"
    click LLMClient "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/clients/llm_client.py"
    click OA "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/clients/generic_openai_api.py"
    click OM "https://github.com/sekju/video-analyzer/blob/main/video_analyzer/clients/ollama.py"
    click UI "https://github.com/sekju/video-analyzer/blob/main/video-analyzer-ui/video_analyzer_ui/server.py"
    click Json "https://github.com/sekju/video-analyzer/blob/main/docs/sample_analysis.json"
    click test_prompt_loading "https://github.com/sekju/video-analyzer/blob/main/test_prompt_loading.py"

    %% Styles
    classDef extraction fill:#ccffcc,stroke:#333
    classDef analysis fill:#ffffcc,stroke:#333
    classDef llm fill:#cce5ff,stroke:#333
    classDef ui fill:#ffdd99,stroke:#333
    classDef cli fill:#ffdd99,stroke:#333
    classDef config fill:#e0e0e0,stroke:#333
    classDef external fill:#f0f0f0,stroke:#333
    classDef output fill:#e0c8ff,stroke:#333
```
