How sekju/video-analyzer works
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