# leandrosalvas/shorts_ai_stack architecture

> Architecture diagram of the GitHub repository leandrosalvas/shorts_ai_stack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leandrosalvas/shorts_ai_stack
- Repository: https://github.com/leandrosalvas/shorts_ai_stack

## Overview

Shorts AI Studio transforma vídeos locais em Shorts/Reels verticais: a pessoa envia um vídeo pela interface ou o coloca na pasta de entrada; o gerador transcreve, pede ao Ollama a seleção de momentos e renderiza os clipes com overlays e um encoder FFmpeg. A configuração central define caminhos e backends. O README também documenta diagnóstico do ambiente e teste isolado do Ollama. As ligações do fluxo principal estão apoiadas no README e nos trechos ou referências do índice; o código não amostrado limita detalhes internos dessas etapas.

Main entry points: [`gerador.py`](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/gerador.py) (Gerador de Shorts), [`config.py`](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/config.py) (Configuração central), [`app_gradio.py`](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/app_gradio.py) (Interface web), [`ollama_utils.py`](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/ollama_utils.py) (Seleção de momentos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interface e entrada"]
  node_ui["Interface web<br/>[app_gradio.py]"]
  node_input[("Vídeos brutos")]
end

subgraph group_pipeline["Pipeline de conteúdo"]
  node_generator["Gerador de Shorts<br/>[gerador.py]"]
  node_transcription["Transcrição Whisper<br/>[gerador.py]"]
  node_whisper_backend["Seleção Whisper<br/>[whisper_backend.py]"]
  node_moment_selection["Seleção de momentos<br/>[ollama_utils.py]"]
  node_outputs[("Shorts prontos")]
end

subgraph group_render["Renderização"]
  node_overlays["Overlays e legendas<br/>[overlays.py]"]
  node_codec["Seleção de encoder<br/>[video_codecs.py]"]
end

subgraph group_runtime["Configuração e diagnóstico"]
  node_config["Configuração central<br/>[config.py]"]
  node_hardware["Detecção de hardware<br/>[hardware.py]"]
  node_environment_diagnostic["Diagnóstico do ambiente"]
  node_ollama_diagnostic["Teste do Ollama"]
end

node_person(("Pessoa"))
node_ollama["Servidor Ollama"]
node_ffmpeg["FFmpeg"]

node_person -->|"envia vídeo"| node_ui
node_ui -->|"copia upload"| node_input
node_input -->|"lê vídeos"| node_generator
node_ui -->|"invoca pipeline"| node_generator
node_generator -->|"transcreve"| node_transcription
node_generator -->|"resolve backend"| node_whisper_backend
node_generator -->|"analisa transcrição"| node_moment_selection
node_moment_selection -->|"solicita momentos"| node_ollama
node_generator -->|"aplica overlays"| node_overlays
node_generator -->|"seleciona encoder"| node_codec
node_generator -->|"renderiza clipes"| node_ffmpeg
node_codec -->|"configura encode"| node_ffmpeg
node_generator -->|"grava resultados"| node_outputs
node_config -->|"configura pipeline"| node_generator
node_config -->|"define backends"| node_whisper_backend
node_config -->|"define Ollama"| node_moment_selection
node_config -->|"configura overlays"| node_overlays
node_config -->|"define codecs"| node_codec
node_ui -->|"exibe capacidade"| node_hardware
node_environment_diagnostic -->|"verifica hardware"| node_hardware
node_environment_diagnostic -->|"testa encoders"| node_codec
node_environment_diagnostic -->|"verifica backend"| node_whisper_backend
node_ollama_diagnostic -->|"lê transcrição"| node_outputs
node_ollama_diagnostic -->|"testa análise"| node_moment_selection
node_ollama_diagnostic -->|"verifica serviço"| node_ollama

click node_ui "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/app_gradio.py"
click node_input "https://github.com/leandrosalvas/shorts_ai_stack/tree/main/videos_brutos"
click node_generator "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/gerador.py"
click node_transcription "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/gerador.py"
click node_whisper_backend "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/whisper_backend.py"
click node_moment_selection "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/ollama_utils.py"
click node_outputs "https://github.com/leandrosalvas/shorts_ai_stack/tree/main/shorts_prontos"
click node_overlays "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/overlays.py"
click node_codec "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/video_codecs.py"
click node_config "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/config.py"
click node_hardware "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/hardware.py"
click node_environment_diagnostic "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/diagnostico_ambiente.py"
click node_ollama_diagnostic "https://github.com/leandrosalvas/shorts_ai_stack/blob/main/diagnosticar_ollama.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_input toneBlue
class node_generator,node_transcription,node_whisper_backend,node_moment_selection,node_outputs toneAmber
class node_overlays,node_codec toneMint
class node_config,node_hardware,node_environment_diagnostic,node_ollama_diagnostic toneRose
class node_person,node_ollama,node_ffmpeg toneIndigo
```

## Components

### Interface e entrada

- [Interface web](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/app_gradio.py): `app_gradio.py`
- [Vídeos brutos](https://github.com/leandrosalvas/shorts_ai_stack/tree/main/videos_brutos): `videos_brutos`

### Pipeline de conteúdo

- [Gerador de Shorts](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/gerador.py): `gerador.py`
- [Transcrição Whisper](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/gerador.py): `gerador.py`
- [Seleção Whisper](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/whisper_backend.py): `whisper_backend.py`
- [Seleção de momentos](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/ollama_utils.py): `ollama_utils.py`
- [Shorts prontos](https://github.com/leandrosalvas/shorts_ai_stack/tree/main/shorts_prontos): `shorts_prontos`

### Renderização

- [Overlays e legendas](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/overlays.py): `overlays.py`
- [Seleção de encoder](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/video_codecs.py): `video_codecs.py`

### Configuração e diagnóstico

- [Configuração central](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/config.py): `config.py`
- [Detecção de hardware](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/hardware.py): `hardware.py`
- [Diagnóstico do ambiente](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/diagnostico_ambiente.py): `diagnostico_ambiente.py`
- [Teste do Ollama](https://github.com/leandrosalvas/shorts_ai_stack/blob/main/diagnosticar_ollama.py): `diagnosticar_ollama.py`

### Other components

- **Pessoa**
- **Servidor Ollama**
- **FFmpeg**

## Connections

- Pessoa → Interface web: envia vídeo (evidence: `README.md`)
- Interface web → Vídeos brutos: copia upload (evidence: `app_gradio.py`)
- Vídeos brutos → Gerador de Shorts: lê vídeos (evidence: `gerador.py`)
- Interface web → Gerador de Shorts: invoca pipeline (evidence: `app_gradio.py`)
- Gerador de Shorts → Transcrição Whisper: transcreve (evidence: `README.md`)
- Gerador de Shorts → Seleção Whisper: resolve backend (evidence: `gerador.py`)
- Gerador de Shorts → Seleção de momentos: analisa transcrição (evidence: `gerador.py`)
- Seleção de momentos → Servidor Ollama: solicita momentos (evidence: `README.md`)
- Gerador de Shorts → Overlays e legendas: aplica overlays (evidence: `gerador.py`)
- Gerador de Shorts → Seleção de encoder: seleciona encoder (evidence: `gerador.py`)
- Gerador de Shorts → FFmpeg: renderiza clipes (evidence: `README.md`)
- Seleção de encoder → FFmpeg: configura encode (evidence: `video_codecs.py`)
- Gerador de Shorts → Shorts prontos: grava resultados (evidence: `gerador.py`)
- Configuração central → Gerador de Shorts: configura pipeline (evidence: `gerador.py`)
- Configuração central → Seleção Whisper: define backends (evidence: `whisper_backend.py`)
- Configuração central → Seleção de momentos: define Ollama (evidence: `ollama_utils.py`)
- Configuração central → Overlays e legendas: configura overlays (evidence: `overlays.py`)
- Configuração central → Seleção de encoder: define codecs (evidence: `video_codecs.py`)
- Interface web → Detecção de hardware: exibe capacidade (evidence: `app_gradio.py`)
- Diagnóstico do ambiente → Detecção de hardware: verifica hardware (evidence: `diagnostico_ambiente.py`)
- Diagnóstico do ambiente → Seleção de encoder: testa encoders (evidence: `diagnostico_ambiente.py`)
- Diagnóstico do ambiente → Seleção Whisper: verifica backend (evidence: `diagnostico_ambiente.py`)
- Teste do Ollama → Shorts prontos: lê transcrição (evidence: `diagnosticar_ollama.py`)
- Teste do Ollama → Seleção de momentos: testa análise (evidence: `diagnosticar_ollama.py`)
- Teste do Ollama → Servidor Ollama: verifica serviço (evidence: `diagnosticar_ollama.py`)
