Limpeza de E-mails

Aplicacao local para revisar e mover e-mails do Gmail para a lixeira. Ela permite limpar tudo ou selecionar remetentes especificos, filtrando mensagens vistas e nao vistas.

O sistema roda no navegador com Streamlit, mas a execucao e local na maquina do usuario.

Requisitos

• Python 3.10 ou superior
• python3-venv e python3-pip instalados no sistema
• Conta Gmail com IMAP ativo
• Senha de aplicativo do Google

Configurar Gmail

1. Ative IMAP no Gmail: Configuracoes > Ver todas as configuracoes > Encaminhamento e POP/IMAP > Ativar IMAP.
2. Crie uma senha de aplicativo: Conta Google > Seguranca > Verificacao em duas etapas > Senhas de app.
3. Use a senha de aplicativo no sistema. A senha normal da conta geralmente nao funciona.

Instalar

git clone https://github.com/Joao-Fernandes00/Limpeza-de-e-mails.git
cd Limpeza-de-e-mails
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

No Ubuntu/Debian, se aparecer erro dizendo que pip ou ensurepip nao existe, instale os pacotes do sistema antes:

sudo apt update
sudo apt install -y python3-venv python3-pip

Depois recrie o ambiente virtual:

rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Rodar

source .venv/bin/activate
streamlit run app.py

Depois abra o endereco mostrado pelo Streamlit no navegador.

Normalmente sera algo como http://localhost:8501.

Como usar

1. Informe seu e-mail Gmail e a senha de aplicativo.
2. Escolha se quer incluir mensagens vistas, nao vistas ou ambas.
3. Clique em Carregar remetentes.
4. Escolha Limpar tudo ou marque remetentes especificos.
5. Gere a previa.
6. Confirme e clique em Mover para lixeira.

Observacoes

• A aplicacao nao salva sua senha em arquivo.
• A primeira versao atua na pasta INBOX.
• As mensagens sao movidas para a lixeira do Gmail, nao apagadas definitivamente.