knotebook
Knotebook es un sistema de notas colaborativas auto-alojable estilo Notion/HackMD con edición en tiempo real CRDT (Yjs), autenticación propia y soporte para endpoints de IA externos sin vendor lock-in.
Ficha actualizada 25 sept 2026, 17:29 · upstream 25 sept 2026, 17:27 · release v0.4.1
Qué es knotebook
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Knotebook es una aplicación open-source de gestión de notas diseñada para ser auto-alojada, ofreciendo funcionalidades similares a Notion o HackMD con edición colaborativa en tiempo real basada en CRDT (Yjs). Permite la integración flexible con proveedores de IA externos mediante endpoints compatibles con OpenAI o Anthropic, incluyendo opciones locales como Ollama, eliminando el vendor lock-in. La arquitectura se basa en React y Node.js, con PostgreSQL como base de datos persistente.
El sistema incluye una interfaz web completa para gestión de notas, wikilinks con backlinks, subida de imágenes, diagramas Mermaid y acciones rápidas de IA (resumen, traducción, reescritura). Cuenta con API REST documentada, soporte para tokens API personales, autenticación mediante credenciales administrativas o OIDC/SSO opcional, y gestión de permisos por roles. La instalación inicial requiere configuración manual de variables de entorno, incluyendo APP_SECRET y credenciales de administrador.
La aplicación está diseñada para despliegues en contenedores Docker con docker compose, aunque no soporta escalado horizontal debido a que el estado colaborativo reside en memoria del servidor sin sincronización entre instancias. Incluye suite de pruebas Playwright, documentación exhaustiva y licencias MIT claras.
- Auto-alojamiento de un sistema de notas colaborativas para equipos internos sin límites de usuarios
- Integración con modelos locales o endpoints propios de IA para procesamiento de texto en el editor
- Gestión de documentación técnica con wikilinks, diagramas Mermaid y backlinks automáticos
- Desarrollo de clientes personalizados mediante la API REST documentada sin dependencias del frontend
- Edición colaborativa en tiempo real basada en CRDT (Yjs) sin límites de usuarios ni licencias
- Integración con endpoints de IA externos (OpenAI/Anthropic/Ollama) sin vendor lock-in
- API REST completa con tokens API personales y soporte para clientes MCP
- Gestión de permisos por roles, wikilinks con backlinks y diagramas Mermaid integrados
- No soporta escalado horizontal: el estado colaborativo reside en memoria del servidor sin sincronización entre instancias
- La autenticación inicial requiere configuración manual de credenciales administrativas en variables de entorno
- El soporte para IA depende completamente de endpoints externos configurados por el administrador
- No incluye OAuth nativo en la versión actual, requiriendo OIDC/SSO como alternativa opcional
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.
Desplegar detrás de un reverse proxy con TLS fuera de localhost. Configurar PUBLIC_URL y TRUST_PROXY correctamente. Usar docker compose para levantar app y db. Generar APP_SECRET con openssl antes del inicio. Solo una instancia de app permitida por el estado colaborativo en memoria.
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.