owlmail
OwlMail es un gateway auto-alojado nativo de IA para pruebas de correo electrónico, pipelines CI y agentes de codificación. Captura mensajes antes de llegar a bandejas reales, los convierte en datos deterministas y permite inspección vía Web UI, REST API versionada, WebSocket y MCP read-only.
Ficha actualizada 27 sept 2026, 20:42 · upstream 27 sept 2026, 20:11 · release v0.10.0
Qué es owlmail
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
OwlMail es una herramienta auto-alojada diseñada para desarrolladores, pipelines CI y agentes de codificación que necesitan probar flujos de correo electrónico de forma fiable. Captura mensajes antes de que lleguen a bandejas reales y los convierte en datos deterministas e inspeccionables mediante un commit atómico único.
La herramienta ofrece múltiples interfaces según el consumidor: desarrolladores usan la Web UI para inspeccionar HTML, metadatos y adjuntos; suites de pruebas consumen la REST API versionada con OpenAPI 3.1 y eventos WebSocket; sistemas de automatización usan Webhooks firmados con HMAC; agentes de IA acceden mediante MCP read-only sin dependencia de LLM.
OwlMail incluye características operacionales explícitas como límites de capacidad SMTP, persistencia opcional en S3/MinIO, métricas Prometheus, logs JSON y políticas de recuperación. Soporta migración desde MailDev y MailCatcher manteniendo workflows existentes sin equivalencia exacta con Socket.IO.
- Pruebas de integración para flujos de correo como reset de contraseña, verificación de email y notificaciones
- Automatización de pipelines CI/CD que consumen eventos duraderos vía Webhooks firmados o Redis Streams
- Agentes de IA que buscan, recuperan y esperan correos mediante MCP read-only sin acceso destructivo
- Desarrollo local con inspección en tiempo real de mensajes capturados en la Web UI
- Migración desde MailDev/MailCatcher manteniendo workflows existentes con facades REST opcionales
- Captura determinista: EML, metadatos y adjuntos se estajan antes del commit atómico que los hace visibles a APIs
- API REST versionada en /api/v1 con OpenAPI 3.1, WebSocket nativo y probes de salud/readiness
- MCP read-only por defecto desactivado: expone siete herramientas cerradas, recursos limitados y wait_for_email sin LLM
- Webhooks firmados con HMAC, delivery IDs estables, límites de retry y graceful drain para automatización durable
- Observabilidad explícita con métricas Prometheus, logs JSON, SQLite indexing y persistencia opcional en S3
- Soporte multi-arquitectura (linux/amd64, linux/arm64) con Docker Buildx y tags exactos o SHA para CI
- No es un MTA público ni servicio multi-inquilino; diseñado para desarrollo, testing, CI y redes internas de confianza
- No garantiza exactly-once delivery sin configuración adicional de persistencia en disco o Redis Streams
- MCP endpoint desactivado por defecto; requiere activación manual con -mcp-enabled y configuración de sesión
- Web UI y REST API requieren HTTPS o localhost confiable para notificaciones del navegador (API Notifications)
- Puertos públicos expuestos sin filtrar DOCKER-USER/nftables/firewalld comprometen tokens, códigos y enlaces de reset
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar tags exactos (0.10.0) o SHA en producción; evitar latest. Publicar puertos solo en loopback (-p 127.0.0.1:PORT:PORT). Configurar firewall DOCKER-USER o nftables/firewalld para filtrar tráfico externo. No usar -web-host 0.0.0.0 sin reglas de seguridad explícitas. Habilitar -metrics-enabled con autenticación básica si se expone /metrics. Para migraciones, verificar compatibilidad REST con MailDev/MailCatcher en docs.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.