FediloveBot 💘

Bot de amor, ligue y amistad para el Fediverso. Diva pop, pitonisa simpática y cronista del salseo fino.

Qué hace

Responde a menciones en Mastodon con consejos, piropos, cotilleo, compatibilidades, juegos y conversación libre sobre amor, ligue y amistad. Usa la API de Groq (Llama 4 Scout) para generar respuestas con personalidad propia, con frases fijas como fallback si Groq no está disponible.

Entiende lenguaje natural — no hace falta usar comandos para pedir un horóscopo, cotilleo, un piropo o consejo. Los comandos son para funciones que necesitan estructura explícita.

Comandos

Comando	Descripción
/me_gusta @usuario	Declara tu interés con chispa
/compatibilidad @usuario	% de compatibilidad (absurdo pero consistente)
/presentar @u1 @u2	Haz de cupido
/oracle <pregunta>	Consulta a la pitonisa fediversiana
/juego	Minijuego de situaciones absurdas
/reto [fácil|medio|atrevido]	Reto social con nivel opcional
/confesar <msg>	Toot anónimo público (solo por DM)
/secreto <msg>	Como /confesar pero se publica mañana
/stats	Tus estadísticas
/ayuda	Menú de comandos

Lenguaje natural

También puedes hablar directamente sin comandos:

• "dime un cotilleo" → lectura de vibes y salseo fino
• "horóscopo Aries" → predicción glam con seguridad absurda
• "dime un piropo" → texto listo para copiar y mandar
• "necesito consejo" → consejo claro y breve
• "hola", "gracias", conversación libre → responde en personaje

Requisitos

• Python 3.10+
• Cuenta en console.groq.com (free tier suficiente)

Instalación

pip install mastodon.py python-dotenv beautifulsoup4 groq

Variables de entorno

FEDILOVE_TOKEN=tu_token_de_mastodon
GROQ_API_KEY=gsk_tukey
BOT_TIMEZONE=Europe/Madrid  # opcional, por defecto Europe/Madrid

Funcionamiento técnico

• Respuestas generadas por Llama 4 Scout vía Groq con frases fijas como fallback
• Contexto de conversación: sube por el hilo para que Groq vea mensajes anteriores
• Clasificación por intención antes de enrutar — lenguaje natural, temático, social o comando
• Validación de respuestas de Groq: filtra hostilidad, cursilería genérica, formas de género no deseadas y menciones a IA
• Compatibilidad consistente vía SHA256 — mismo resultado para la misma pareja siempre
• Confesionario anónimo y secretos programados vía SQLite (WAL)
• Post diario automático a las 9:00 (hora configurable)
• Respeta #nobot — verifica perfil y menciones antes de responder
• Cooldown de 10 segundos por usuario
• Backoff exponencial en reconexión al stream
• Limpieza periódica de memoria en el scheduler

Privacidad

Los mensajes se procesan mediante la API de Groq. Consulta PRIVACY.md para más detalles.

Créditos

• Groq Python SDK
• Llama 4 Scout — Meta
• Mastodon.py