https://github.com/gustavo-mmh/synopz
Uma aplicação Flask para resumir vídeos do YouTube utilizando a API do Google AI Studio (Gemini). O projeto extrai legendas de vídeos e gera resumos estruturados com base no conteúdo.
https://github.com/gustavo-mmh/synopz
bootstrap django flask gemini google-ai-studio python youtube-api
Last synced: 5 months ago
JSON representation
Uma aplicação Flask para resumir vídeos do YouTube utilizando a API do Google AI Studio (Gemini). O projeto extrai legendas de vídeos e gera resumos estruturados com base no conteúdo.
- Host: GitHub
- URL: https://github.com/gustavo-mmh/synopz
- Owner: gustavo-mmh
- License: mit
- Created: 2025-04-05T20:44:59.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-06T21:02:36.000Z (5 months ago)
- Last Synced: 2025-05-06T21:37:00.504Z (5 months ago)
- Topics: bootstrap, django, flask, gemini, google-ai-studio, python, youtube-api
- Language: TypeScript
- Homepage:
- Size: 2.05 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Synopz
## 📌 Sobre o Projeto
O **Synopz** é uma aplicação web full stack composta por backend em Flask e frontend em Angular. Seu objetivo é resumir vídeos do YouTube utilizando a API Gemini do Google AI Studio. O sistema extrai legendas dos vídeos, envia o conteúdo para a IA e retorna um resumo estruturado, facilitando o consumo rápido de informações.
---
## 🏗️ Estrutura do Projeto
- **backend/**: API Flask responsável por processar vídeos, extrair legendas e interagir com a API Gemini.
- **frontend/**: Aplicação Angular que fornece a interface web para o usuário inserir links de vídeos e visualizar os resumos.
---
## 🚀 Como Executar Localmente
### 📋 Pré-requisitos
- Python 3.8+
- Node.js 18+ e npm
- Conta no Google AI Studio com acesso à API Gemini
- Chave de API Gemini
### 🔧 Instalação
#### 1. Clone o repositório
```bash
git clone https://github.com/seu-usuario/synopz.git
cd synopz
```
#### 2. Backend (Flask)
```bash
cd backend
python -m venv .venv
# Ative o ambiente virtual:
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate
pip install -r requirements.txt
```
Opcional: Crie um arquivo `.env` com sua chave de API Gemini:
```
GEMINI_API_KEY=sua_chave_aqui
SECRET_KEY=sua_chave_secreta
```
Inicie o servidor Flask:
```bash
python run.py
```
#### 3. Frontend (Angular)
Abra outro terminal e execute:
```bash
cd frontend
npm install
ng serve
```
Acesse o frontend em [http://localhost:4200](http://localhost:4200).
---
## 🧪 Testes
- **Backend:** Os testes estão na pasta `backend/tests/`. Execute com:
```bash
pytest
```
- **Frontend:** Execute testes unitários com:
```bash
ng test
```
Para testes end-to-end:
```bash
ng e2e
```
---
## 🛠️ Tecnologias Utilizadas
- **Backend:** Python, Flask, Google AI Studio API (Gemini)
- **Frontend:** Angular, TailwindCSS
---
## 🤝 Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.
---
## 📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo [LICENSE.md](LICENSE.md) para mais detalhes.