Indie Shows Tracker

¿Qué es Hermes?

Hermes es un agente de IA que vive corriendo en un servidor y se comunica conmigo (Mati) principalmente por WhatsApp. No es un chatbot común: además de "hablar", hace cosas concretas.

• Tiene herramientas reales: ejecuta comandos en el servidor, hace web scraping, lee/escribe archivos, manda mensajes de WhatsApp, consulta bases de datos.
• Corre 24/7: tiene tareas programadas (cron jobs) que se ejecutan automáticamente sin que nadie las dispare.
• Tiene memoria entre sesiones: sabe cómo funciona mi servidor, qué proyectos tengo, y tiene skills especializadas.
• Se comunica por WhatsApp: manda y recibe mensajes a grupos a través de un puente (bridge).

¿Qué son las Skills?

Las Skills son manuales de instrucciones que le damos a Hermes para que sepa cómo manejar tareas específicas. Cada skill es un archivo de texto (SKILL.md) que describe:

• Qué hace y cuándo activarse (trigger)
• Pasos concretos para completar la tarea
• Peligros a evitar (pitfalls) para que no se mande una cagada
• Referencias a scripts, bases de datos y APIs relevantes

¿Qué hace el bot?

Rastrea shows en vivo de artistas indie en Buenos Aires y alrededores (CABA, La Plata, Bernal, Quilmes) y manda notificaciones a un grupo de WhatsApp.

Artistas rastreados

Tipos de notificaciones

Arquitectura general

El sistema tiene 5 componentes principales que trabajan juntos:

Cómo busca los recitales

Dos veces por semana (miércoles y sábado a las 11:00), se dispara un cron job que despierta al agente para buscar shows nuevos.

Cómo guarda los datos (SQLite)

SQLite guarda todo en un solo archivo (indie_shows.db). No necesita servidor. Python lo accede con el módulo sqlite3 que viene built-in.

Estructura de la tabla shows

CREATE TABLE shows (
    id           INTEGER PRIMARY KEY,
    artista      TEXT NOT NULL,        -- "Pérez"
    fecha        DATE NOT NULL,         -- "2026-11-01"
    titulo       TEXT NOT NULL,         -- "Pérez presenta..."
    venue        TEXT DEFAULT '',       -- "Club Social 911 (CABA)"
    hora         TEXT DEFAULT '',       -- "21:00"
    precio       TEXT DEFAULT '',       -- "12000"
    link         TEXT DEFAULT '',       -- URL de entradas
    fuente       TEXT DEFAULT '',       -- URL de dónde salió
    detalle      TEXT DEFAULT '',      -- Info adicional
    notif_dia    INT DEFAULT 0,        -- 1=ya se avisó
    notif_sem    INT DEFAULT 0,        -- 1=ya se avisó
    creado_en    DATETIME,
    actualizado  DATETIME,
    UNIQUE(fecha, artista, titulo)     -- Sin duplicados
);

Cómo envía las notificaciones

El script manda el mensaje haciendo un HTTP POST al bridge de Baileys:

curl -s -X POST http://127.0.0.1:3000/send \
  -H "Content-Type: application/json" \
  -d '{"chatId":"120363428208084868@g.us",
       "message":"🎵 ¡Shows indie mañana! ..."}'

El bridge es Baileys, una biblioteca de Node.js que se conecta a WhatsApp Web y expone una API HTTP local. Así podemos enviar mensajes programáticamente desde cualquier script.

Configuración del grupo en WhatsApp

whatsapp:
  channel_prompts:
    "120363428208084868@g.us": |
      GRUPO DE SHOWS INDIE BAIRES.
      REGLAS: 1) NUNCA busques en Google.
      2) TODA la info está en la DB local.
      3) Cargá la skill ANTES de responder.
  channel_skill_bindings:
    - id: "120363428208084868@g.us"
      skills:
        - indie-shows-tracker

Cuando alguien manda un mensaje al grupo, Hermes carga la skill y limita su comportamiento a lo que la skill define.

Los Cron Jobs: tareas programadas

Un cron job es una tarea que se ejecuta automáticamente en un horario determinado. Es como poner una alarma, pero en vez de sonar, ejecuta un programa.

La DB en detalle: queries

Listar próximos shows (90 días)

SELECT * FROM shows
WHERE fecha >= date('now')
  AND fecha <= date('now', '+90 days')
ORDER BY fecha, hora;

Shows de mañana (notificación diaria)

SELECT * FROM shows
WHERE fecha = date('now', '+1 day')
  AND notificado_dia_anterior = 0
ORDER BY hora;

UPSERT (insertar o actualizar)

INSERT INTO shows (artista, fecha, titulo, venue, ...)
VALUES (?, ?, ?, ?, ...)
ON CONFLICT(fecha, artista, titulo) DO UPDATE SET
    venue = excluded.venue,
    hora = excluded.hora,
    link = excluded.link,
    actualizado_en = CURRENT_TIMESTAMP;

Marcar como notificado

UPDATE shows
SET notificado_dia_anterior = 1
WHERE id = ?;

El script Python: modos de uso

python3 /home/mati/indie_shows.py <modo>

  init        → Crear/actualizar la tabla
  add-json    → Agregar shows desde JSON (batch)
  list        → Listar próximos shows (90 días)
  daily       → Notificación día anterior
  weekly      → Resumen semanal (7 días)
  monthly     → Resumen mensual (30 días)
  mark-sent   → Marcar shows como notificados
  cleanup     → Borrar shows pasados
  artists     → Listar artistas rastreados

Ejemplo de inserción

python3 /home/mati/indie_shows.py add-json '[
  {"artista":"Toe", "fecha":"2026-09-13",
   "titulo":"Toe - Latin America Tour 2026",
   "venue":"Niceto Club (CABA)", "hora":"20:00",
   "precio":"55000", "link":"https://venti.com.ar/...",
   "fuente":"https://venti.com.ar/...",
   "detalle":"Banda japonesa, tour latinoamericano"}
]'

Flujo completo paso a paso

Así funciona el sistema de punta a punta cuando busca nuevos shows:

Vocabulario rápido