Hayden Bleasel, un desarrollador experto de OpenAI, lanzó Blume, un marco de documentación de código abierto. Blume se envió a npm como versión 1.0.3 el mismo día. Es tan simple como colocar Markdown en una carpeta y enviar un sitio de documentos. No se escribe ni se mantiene ningún texto estándar de la aplicación después. El proyecto tiene licencia del MIT y es de código abierto.
¿Qué es la flor?
Blume es una herramienta de línea de comandos combinada con una biblioteca de componentes para documentos. Lee una carpeta de archivos Markdown o MDX. A partir de esa carpeta, genera un sitio de documentación de nivel de producción. Esa salida incluye navegación, búsqueda, temática e imágenes de Open Graph. La configuración sigue siendo opcional y se agrega un archivo a la vez. El código es un monorepo de TypeScript; el paquete publicado se encuentra en paquetes/blume. La propia documentación de Blume, en aplicaciones/docs, está creada con el propio Blume. Requiere Node.js 22.12 o posterior. Funciona con Bun, pnpm, npm o hilo.
¿Cómo funciona Blume?
Bajo la superficie, Blume genera e impulsa un proyecto Astro oculto. Primero, la CLI carga blume.config.ts y escanea su contenido en un gráfico. A continuación, escribe un proyecto Astro en un directorio .blume/. Luego, Astro procesa cada página a través de una única ruta general. Esa ruta importa los componentes enviados por Blume, los datos generados y sus anulaciones. En cada ejecución, .blume/ se regenera y solo se reescriben los archivos modificados. Como resultado, la recarga en caliente se mantiene rápida durante la edición. El tema principal no incluye ningún marco de cliente JavaScript. En consecuencia, las páginas obtienen una buena puntuación en Core Web Vitals de forma predeterminada. Cuando necesita control total, Blume Eject convierte el tiempo de ejecución en una aplicación Astro independiente. Ese proyecto expulsado todavía depende del paquete Blume.
Empezando
La configuración requiere un solo comando, por lo que la incorporación es breve.
Luego, blume dev inicia un servidor de recarga en caliente. Mientras tanto, blume build escribe HTML estático y un índice de búsqueda local en dist/. El archivo de configuración es TypeScript real, validado por un esquema.
{ type: “filesystem”, root: “docs” },
{ type: “notion”, database: process.env.NOTION_DB },
]}, });
Debido a que la configuración se escribe, los editores detectan errores antes de que se ejecute una compilación. La CLI cubre el ciclo de vida completo más allá de lo básico:
Listo para IA por diseño
Más allá de los lectores humanos, Blume también se dirige a los agentes. Cada página devuelve Markdown sin formato cuando agrega .md a su URL. Un único indicador emite llms.txt y llms-full.txt para los agentes. Cada página se puede copiar como Markdown o abrir en ChatGPT, Claude o v0. Un asistente opcional de Ask AI en la página responde directamente a las preguntas de los lectores. Se ejecuta en AI SDK a través de Vercel AI Gateway, OpenRouter, Inkeep o cualquier punto final compatible con OpenAI. Blume también puede alojar un servidor Model Context Protocol (MCP). A través de él, Claude Code, Cursor y VS Code leen documentos directamente.
Ese servidor expone cuatro herramientas de solo lectura: search_docs, get_page, list_pages y get_navigation.
Casos de uso con ejemplos
Esas capacidades se corresponden con trabajos concretos. Para un producto API, introduzca una especificación OpenAPI o AsyncAPI. Luego, Blume genera una referencia interactiva con esquemas, autenticación y un área de juegos de solicitudes a través de Scalar. Para una biblioteca, apunte Blume a sus versiones de GitHub. Cada versión se acumula en una línea de tiempo de registro de cambios generada con una fuente RSS. Para una audiencia global, agregue archivos traducidos por configuración regional. Blume admite 36 configuraciones regionales, enrutamiento según la configuración regional y diseños de derecha a izquierda. Para contenido mixto, combine archivos locales con MDX, Notion o Sanity remotos. Todas las fuentes se procesan a través de los mismos componentes.
Cómo se compara Blume
Para contextualizar, aquí presentamos a Blume frente a tres enfoques de documentación comunes. Las funciones cambian rápidamente, así que verifique los detalles actuales antes de adoptarlas.
Fortalezas y debilidades
Fortalezas
Inicio sin configuración: una carpeta de Markdown se convierte en un sitio completo. La primera salida estática no incluye JS de cliente principal, lo que ayuda a Core Web Vitals. Superficies de IA integradas: llms.txt, Markdown por página, servidor MCP y Ask AI. Configuración con seguridad de tipos, para que los editores marquen los errores antes de que se ejecute una compilación. La ruta de expulsión a una aplicación Astro independiente reduce el bloqueo a largo plazo.
Debilidades
La versión 1.0.3 es nueva, por lo que el ecosistema aún es joven. Necesita Node.js 22.12 o posterior, del que carecen algunos entornos. Las funciones en tiempo de solicitud como Ask AI y MCP necesitan un adaptador de servidor. El modelo autohospedado significa que usted posee análisis y cableado asistente. Tiene menos integraciones de terceros que las plataformas alojadas maduras de la actualidad.
Conclusiones clave
Blume convierte una carpeta Markdown en un sitio de documentos de producción sin configuración. Impulsa un proyecto oculto de Astro y Vite y puede expulsarse a un Astro independiente. Las funciones de IA están integradas: llms.txt, Markdown por página y un servidor MCP. Tiene licencia del MIT, necesita Node.js 22.12+ y alcanzó npm v1.0.3 el día del lanzamiento. Los primeros en adoptarlo incluyen Quiver, que pasó de Mintlify, y los documentos add-mcp de Neon.
Consulte el repositorio de GitHub. Además, no dude en seguirnos en Twitter y no olvide unirse a nuestro SubReddit de más de 150.000 ml y suscribirse a nuestro boletín. ¡Esperar! estas en telegrama? Ahora también puedes unirte a nosotros en Telegram.
¿Necesita asociarse con nosotros para promocionar su repositorio de GitHub O su página principal de Hugging O su lanzamiento de producto O seminario web, etc.? Conéctate con nosotros