nornweave
NornWeave es una API auto-hospedada open-source que transforma proveedores de correo estándar (Mailgun, SES) en 'Inbox-as-a-Service' para agentes de IA. Añade estado, threading y búsqueda semántica a correos transaccionales, integrándose vía REST o MCP.
Ficha actualizada 25 sept 2026, 17:01 · upstream 25 sept 2026, 16:30 · release v0.2.0
Qué es nornweave
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NornWeave es una API auto-hospedada open-source diseñada para convertir proveedores de correo estándar como Mailgun, SES o SendGrid en un servicio 'Inbox-as-a-Service' optimizado para agentes de IA. A diferencia de las APIs de correo tradicionales que son stateless y transaccionales, NornWeave introduce una capa de estado (cajas de entrada, hilos, historial) y una capa inteligente (parsing de Markdown, búsqueda semántica). El proyecto utiliza una arquitectura inspirada en la mitología nórdica, con componentes como Urdr para almacenamiento, Verdandi para ingestión y Skuld para envío.
El repositorio es un monorepo que incluye el paquete principal en Python, clientes SDK, nodos para n8n y documentación Hugo. Soporta múltiples backends de almacenamiento (SQLite por defecto o PostgreSQL) y bases de datos como Redis. Ofrece integración nativa con servidores MCP para conectarse directamente con herramientas como Cursor o Claude, permitiendo a los agentes leer recursos y ejecutar herramientas de forma directa.
- Provisionar direcciones de correo virtuales para agentes de IA autónomos que necesiten interactuar con humanos.
- Integración nativa con clientes MCP (Cursor, Claude) para gestionar bandejas de entrada sin intermediarios.
- Gestión de tickets de soporte automatizados mediante parsing de HTML a Markdown y resumen de hilos.
- Búsqueda semántica en historiales de correo utilizando embeddings vectoriales con pgvector.
- Despliegue local o en infraestructura propia para cumplir con normativas de privacidad de datos.
- Soporte multi-proveedor: Envío y recepción vía Mailgun, SES, SendGrid, Resend e IMAP/SMTP.
- Integración nativa con protocolo MCP (Model Context Protocol) para agentes de IA modernos.
- Arquitectura modular inspirada en mitología nórdica con componentes claramente definidos.
- Capacidad de parsing de contenido: conversión HTML a Markdown y extracción de texto de PDFs.
- Almacenamiento persistente configurable entre SQLite y PostgreSQL con adaptadores abstractos.
- La funcionalidad real de envío/recepción depende de la configuración correcta de claves API del proveedor externo.
- El modo demo es un sandbox local; para producción se requiere configurar un dominio y proveedor real.
- Algunas funciones como 'wait_for_reply' están marcadas como experimentales en la documentación.
- La migración de base de datos requiere ejecución manual de comandos si se utiliza PostgreSQL.
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.
Para producción, clona el repositorio y usa Docker Compose. Copia .env.example a .env y configura EMAIL_PROVIDER (ej. mailgun) y EMAIL_DOMAIN. Ejecuta 'docker compose up -d' y las migraciones con 'alembic upgrade head' si usas PostgreSQL. Asegura los puertos 8000, 5432 y 6379 en el firewall.
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.