Yappy 🐶

Assistente de engajamento no LinkedIn com inteligência artificial. Descubra automaticamente publicações do LinkedIn e deixe comentários atenciosos, únicos e gerados por IA que realmente soam como você.

O Yappy é uma poderosa ferramenta baseada em terminal que usa o Google Gemini AI e a automação de navegador Playwright para ajudar você a se manter ativo no LinkedIn sem a rolagem sem sentido.

Início rápido

Instale o Yappy usando seu gerenciador de pacotes favorito:

pip (Recomendado)

pip install yappy
yap

Para executar o programa

yap              # Iniciar painel TUI
yap onboarding   # Executar o assistente de configuração manualmente
yap --no-tui     # Executar em modo CLI sem interface
yap --report     # Mostrar relatório de atividade
yap --about      # Mostrar versão e informações do sistema

✨ Primeiros Passos (Sua Primeira Execução)

Na primeira vez que você executar yap, o Yappy iniciará com um assistente de configuração para ajudá-lo a se preparar em minutos. Você pode executá-lo novamente a qualquer momento com yap onboarding.

1. Configuração Automática: O Yappy instalará automaticamente o navegador Playwright necessário e criará seus arquivos de configuração.
2. Seu "Cérebro" de IA: Você precisará de uma chave de API do Google Gemini. Elas são atualmente gratuitas e podem ser obtidas no Google AI Studio.
3. Login Seguro: O Yappy abrirá uma janela do navegador para você fazer login no LinkedIn. Sua senha nunca é vista ou armazenada pelo Yappy. Ele salva de forma segura o "cookie" da sua sessão localmente no seu computador, para que você permaneça logado em execuções futuras.
4. Pronto para Usar: Uma vez conectado, o Yappy está pronto para começar a encontrar publicações para você!

📺 Gerenciando seu Bot

O Yappy oferece duas formas de execução, dependendo se você deseja assistir à mágica acontecer ou deixá-lo funcionar silenciosamente em segundo plano.

1. O Painel Yappy (TUI)

Basta executar yap para abrir o painel interativo.

• Feed ao Vivo: Assista em tempo real enquanto o Yappy descobre publicações e redige comentários atenciosos.
• Painel de Estatísticas: Acompanhe seu progresso diário e a saúde da conta.
• Estratégia Atual: Veja sua persona de IA ativa e regras de segmentação em um relance.
• Editor de Configuração: Ajuste suas configurações, gerencie sua Chave de API do Gemini e atualize seu Login no LinkedIn diretamente do terminal.

2. Modo em Segundo Plano (CLI)

Se você preferir deixar o Yappy trabalhar enquanto foca em outras coisas:

yap --no-tui

Você pode verificar o progresso a qualquer momento executando um relatório:

yap --report

Personalização

A configuração é armazenada em ~/.config/yappy/config.yaml. Você pode personalizar seus alvos:

targets:
  - type: feed          # Seu feed inicial
    max_posts: 15
  - type: keyword       # Tópicos específicos
    value: "AI startups"
    max_posts: 5

Desinstalação

Para remover o Yappy do seu sistema:

1. Remover o pacote

pip uninstall yappy
# OU se instalado via Homebrew:
brew uninstall yappy

2. Limpar dados locais (Opcional)

Para remover completamente sua configuração, sessão do LinkedIn e logs de atividade:

# macOS
rm -rf ~/Library/Application\ Support/yappy
rm -rf ~/.config/yappy

# Linux
rm -rf ~/.local/share/yappy
rm -rf ~/.config/yappy

Licença

Distribuído sob a Licença MIT. Consulte LICENSE para mais informações.

O Yappy é um projeto independente e não é afiliado, autorizado, mantido, patrocinado ou endossado pela LinkedIn Corporation.