An open API service indexing awesome lists of open source software.

https://github.com/alan-oliveir/sentiment_radar_app

Aplicação web interativa desenvolvida em Python com Streamlit, que permite ao usuário pesquisar a percepção pública sobre produtos, serviços ou marcas com base em postagens extraídas do Reddit.
https://github.com/alan-oliveir/sentiment_radar_app

nlp python streamlit

Last synced: 5 months ago
JSON representation

Aplicação web interativa desenvolvida em Python com Streamlit, que permite ao usuário pesquisar a percepção pública sobre produtos, serviços ou marcas com base em postagens extraídas do Reddit.

Awesome Lists containing this project

README

          

# Sentiment Radar – Análise de Sentimentos com Python, Streamlit e Reddit

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://sentimentradarapp-6rusrx3rigukjgvsygesud.streamlit.app/)

**Sentiment Radar** é uma aplicação web interativa que permite descobrir o que as pessoas realmente pensam sobre produtos, serviços ou marcas, analisando postagens do Reddit em tempo real.

## 📚 Sumário

- [Funcionalidades](#-funcionalidades)
- [Demo Online](#-demo-online)
- [Screenshots](#-screenshots)
- [Instalação Rápida](#-instalação-rápida)
- [Como Usar](#-como-usar)
- [Tecnologias Utilizadas](#-tecnologias-utilizadas)
- [Estrutura do Projeto](#-estrutura-do-projeto)
- [Uso de IA no Desenvolvimento](#-uso-de-ia-no-desenvolvimento)
- [Contribuindo](#-contribuindo)
- [Licença](#-licença)
- [Contato](#-contato)
- [Autor](#-autor)

## 🌟 Funcionalidades

- **Análise em Tempo Real**: Busca e analisa posts recentes do Reddit
- **Processamento de Linguagem Natural**: Identifica sentimentos positivos, neutros e negativos
- **Visualizações Interativas**:
- Gráficos de distribuição de sentimentos
- Nuvens de palavras com os termos mais frequentes
- Lista de posts analisados com sentimento estimado
- **Exportação de Dados**: Baixe os resultados para análise posterior

## 🚀 Demo Online

Experimente agora mesmo! Acesse a aplicação através do link abaixo:
[https://sentimentradarapp-6rusrx3rigukjgvsygesud.streamlit.app/](https://sentimentradarapp-6rusrx3rigukjgvsygesud.streamlit.app/)

## 📸 Screenshots

![Screenshot](https://github.com/Alan-oliveir/Sentiment_Radar_APP/blob/master/images/screenshot.png)

## 🛠️ Instalação Rápida

```bash
# Clonar o repositório
git clone https://github.com/Alan-oliveir/Sentiment_Radar_APP.git
cd sentiment_radar_app

# Instalar dependências
pip install -r requirements.txt

# Executar a aplicação
streamlit run app.py
```

> ⚠️ **Importante**: Você precisará de credenciais da API do Reddit para usar todas as funcionalidades.
> Crie suas credenciais em: https://www.reddit.com/prefs/apps
> Para instruções detalhadas, consulte [configuration_guide](docs/configuration_guide.md).

## 🧩 Como Usar

1. Insira suas credenciais da API do Reddit
2. Digite uma palavra-chave para pesquisa (ex: "iPhone", "Tesla", "ChatGPT")
3. Opcionalmente, especifique um subreddit específico
4. Ajuste os parâmetros de busca conforme necessário
5. Clique em "Analisar Sentimentos"
6. Explore as visualizações e insights gerados

## 🔧 Tecnologias Utilizadas

- **Python** – linguagem principal
- **Streamlit** – interface web interativa
- **PRAW** (Python Reddit API Wrapper) – coleta de dados do Reddit
- **TextBlob** – análise de sentimento
- **Matplotlib / WordCloud** – visualizações gráficas

## 📂 Estrutura do Projeto

```plaintext
sentiment_radar_app/
├── app.py # Aplicação principal
├── reddit_client.py # Integração com API do Reddit
├── sentiment_analyzer.py # Análise de sentimento
├── visualization.py # Componentes visuais
├── resource_manager.py # Gerenciador de recursos
├── static/ # Recursos estáticos
│ ├── styles.css # Estilos da aplicação
│ └── theme_detector.js # Detecção de tema
├── docs/ # Documentação do projeto
│ ├── index.md # Índice da documentação
│ ├── ai_usage.md # Uso de IA no projeto
│ ├── ai_prompts_log.md # Registro de prompts utilizados
│ ├── configuration_guide.md # Configuração e uso
│ └── contribution_guide.md # Guia de contribuição
├── requirements.txt # Dependências
├── LICENSE # Licença do projeto
├── CONTRIBUTING.md # Diretrizes de contribuição
└── README.md # Documentação principal
```

## 🤖 Uso de IA no Desenvolvimento

Este projeto foi desenvolvido com suporte de ferramentas de Inteligência Artificial. Para garantir transparência:

- **[ai_usage.md](docs/ai_usage.md)**: Resumo das ferramentas de IA utilizadas, áreas de aplicação e casos de uso
específicos.
- **[ai_prompts_log.md](docs/ai_prompts_log.md)**: Registro detalhado dos prompts utilizados, resultados obtidos e ajustes manuais
realizados.

Estas informações visam documentar o processo criativo e dar crédito apropriado às ferramentas usadas, ao mesmo tempo
que mantém a integridade do projeto como produto de supervisão e decisão humana.

## 🤝 Contribuindo

Quer contribuir para o projeto? Ótimo! Confira o nosso [guia de contribuição](CONTRIBUTING.md) para saber como participar.

## 📜 Licença

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)

Este projeto está licenciado sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.

## 📞 Contato

Se você tiver dúvidas ou sugestões, abra uma issue no GitHub ou entre em contato com o desenvolvedor.

---

### 📄 Documentação Completa

Acesse a documentação técnica completa em:
➡️ https://alan-oliveir.github.io/Sentiment_Radar_APP

---

### 👤 Autor

Desenvolvido por **Alan de Oliveira Gonçalves**. Sinta-se à vontade para contribuir e melhorar este projeto!

[![Github](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Alan-oliveir)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/alan-ogoncalves)