Herald: tu repo de GitHub escribe tus posts de marketing con IA
Una herramienta que convierte la actividad de un repositorio en borradores de artículos para dev.to, con revisión y publicación programada.
Herald es una solución original para desarrolladores y equipos pequeños que quieren documentar o comercializar su código sin dedicar horas a redactar. La herramienta vigila los eventos de un repositorio de GitHub -cuando un commit modifica el readme, se añade una feature flag o se publica un release tag- y dispara un webhook hacia un backend en FastAPI. Ese endpoint guarda el evento en una base PostgreSQL a través de SQLAlchemy y pasa el control a un worker de Celery.
El worker pide a OpenAI GPT-4 que redacte un borrador de artículo sobre el cambio detectado. El modelo recibe un prompt conciso y devuelve un texto en Markdown que queda almacenado. El siguiente paso es humano: el desarrollador accede a una interfaz web creada con React y Vite, revisa el borrador, lo edita si es necesario y lo programa en un calendario. En la fecha indicada, otro worker de Celery se encarga de publicarlo en dev.to vía su API, con las etiquetas adecuadas. El proceso es idempotente y reintenta hasta tres veces si la llamada falla.
Además, después de la publicación, Herald consulta cada doce horas las lecturas del artículo para mostrar en el dashboard una visión de la acogida que tiene cada post.
El proyecto también toca temas interesantes de rendimiento. La tabla de triggers no procesados se lee completa en una sola consulta, acabando con un bucle que degradaba la latencia. El endpoint que lista los triggers ahora pagina los resultados, reduciendo un pico de memoria que multiplicaba por veinte el consumo. Y se ha añadido un límite duro a las consultas para evitar sobrecargas. La suite de tests cubre el 100% del código y un reciente ajuste sustituye el cálculo de bcrypt por un mock en las pruebas, lo que acelera la ejecución.
Lo más valioso no es la parte de generación de texto, sino la integración con el flujo real de desarrollo. Mantener un blog técnico normalmente se abandona por falta de tiempo; aquí el repositorio funciona como fuente automática de ideas y primeras versiones. Eso sí, el contenido generado por GPT-4 necesita revisión humana: el propio autor asume que los borradores son un punto de partida, no el producto final.
La herramienta está en uso en su propio proyecto, pero no hay una demo pública ni métricas detalladas de engagement más allá del conteo de lecturas. Si esperas que la IA escriba por ti sin supervisión, puede que te decepcione; si lo ves como una forma de reducir la fricción entre el código y la comunicación, merece la pena echarle un ojo.
