Yappy 🐶

Asistente de participación en LinkedIn impulsado por IA. Descubre automáticamente publicaciones de LinkedIn y deja comentarios reflexivos, únicos y generados por IA que realmente suenan como tú.

Yappy es una potente herramienta de terminal que utiliza Google's Gemini AI y la automatización del navegador Playwright para ayudarte a mantenerte activo en LinkedIn sin el desplazamiento sin sentido.

Inicio rápido

Instala Yappy usando tu gestor de paquetes favorito:

pip (Recomendado)

pip install yappy
yap

Para ejecutar el programa

yap              # Launch TUI dashboard
yap onboarding   # Manually run the setup wizard
yap --no-tui     # Run in headless CLI mode
yap --report     # Show activity report
yap --about      # Show version and system info

✨ Primeros pasos (Tu primera ejecución)

La primera vez que ejecutes yap, Yappy se iniciará con un asistente de configuración para ayudarte a prepararte en minutos. Puedes volver a ejecutarlo en cualquier momento usando yap onboarding.

1. Configuración automática: Yappy instalará automáticamente el navegador Playwright necesario y creará tus archivos de configuración.
2. Tu "cerebro" de IA: Necesitarás una clave API de Google Gemini. Actualmente son gratuitas y se pueden obtener desde Google AI Studio.
3. Inicio de sesión seguro: Yappy abrirá una ventana del navegador para que inicies sesión en LinkedIn. Tu contraseña nunca es vista ni almacenada por Yappy. Guarda de forma segura tu "cookie" de sesión localmente en tu computadora, para que permanezcas conectado en futuras ejecuciones.
4. Listo para empezar: Una vez conectado, Yappy estará listo para empezar a encontrar publicaciones para ti.

📺 Gestionando tu bot

Yappy ofrece dos formas de ejecutarse, dependiendo de si quieres ver la magia en acción o dejarlo funcionar silenciosamente en segundo plano.

1. El panel de Yappy (TUI)

Solo ejecuta yap para abrir el panel interactivo.

• Feed en vivo: Observa en tiempo real cómo Yappy descubre publicaciones y redacta comentarios reflexivos.
• Panel de estadísticas: Vigila tu progreso diario y la salud de tu cuenta.
• Estrategia actual: Ve tu persona de IA activa y las reglas de segmentación de un vistazo.
• Editor de configuración: Ajusta tus opciones, administra tu Gemini API Key y actualiza tu LinkedIn Login directamente desde la terminal.

2. Modo en segundo plano (CLI)

Si prefieres dejar que Yappy trabaje mientras te concentras en otras cosas:

yap --no-tui

Puedes verificar su progreso en cualquier momento ejecutando un informe:

yap --report

Personalización

La configuración se almacena en ~/.config/yappy/config.yaml. Puedes personalizar tus objetivos:

targets:
  - type: feed          # Your home feed
    max_posts: 15
  - type: keyword       # Specific topics
    value: "AI startups"
    max_posts: 5

Desinstalación

Para eliminar Yappy de tu sistema:

1. Eliminar el paquete

pip uninstall yappy
# OR if installed via Homebrew:
brew uninstall yappy

2. Limpiar datos locales (Opcional)

Para eliminar completamente tu configuración, sesión de LinkedIn y registros de actividad:

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

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

Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para más información.

Yappy es un proyecto independiente y no está afiliado, autorizado, mantenido, patrocinado ni respaldado por LinkedIn Corporation.