obi
Obi es una aplicación web auto-alojada para notas en Markdown con un lienzo integrado, sincronización con GitHub y colaboración en tiempo real. Ofrece whiteboards, soporte para Obsidian y despliegue flexible.
Ficha actualizada 24 sept 2026, 11:39 · upstream 24 sept 2026, 11:16 · release v1.0.0
Qué es obi
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Obi es una aplicación de notas auto-alojada diseñada para usuarios que gestionan sus archivos en formato Markdown y desean mantener su vault en GitHub. Proporciona dos entornos de trabajo: un espacio basado en Git (almacenamiento propio) y un espacio online (servidor local). Ambos soportan edición en tiempo real, colaboración entre dispositivos y sincronización bidireccional con Obsidian.
La aplicación destaca por su lienzo integrado (canvas) que permite añadir notas adhesivas, flechas y diagramas directamente sobre el texto de las notas. Incluye whiteboards completos con herramientas de dibujo, exportación a PNG/SVG y capacidad para incrustar estos elementos en notas. El editor soporta Markdown avanzado, KaTeX para matemáticas, Mermaid para diagramas y resaltado de sintaxis.
La seguridad se gestiona mediante cifrado AES-256-GCM para tokens de GitHub y gestión de sesiones. El despliegue es flexible, compatible con Docker Compose o Dockerfile, y soporta PWA para uso móvil. La administración permite gestionar usuarios, roles y sincronización de repositorios Git.
- Gestión personal de documentación técnica en Markdown con diagramas integrados.
- Creación de wikis internas colaborativas con roles de edición y visualización.
- Sincronización bidireccional entre una instalación local y un repositorio GitHub remoto.
- Uso como alternativa a herramientas propietarias para notas con lienzo y whiteboards.
- Integración con Obsidian mediante sincronización de archivos en tiempo real.
- Edición Markdown nativa con vista previa en vivo estilo Obsidian.
- Lienzo (canvas) integrado que permite dibujar sobre el texto y fijar notas adhesivas.
- Sincronización segura con GitHub mediante cifrado AES-256-GCM para tokens.
- Soporte completo para whiteboards, diagramas Mermaid y expresiones matemáticas KaTeX.
- Colaboración en tiempo real con avatares de presencia y cursores compartidos.
- Despliegue auto-alojado sin dependencias de nube propietarias.
- Requiere configuración SMTP para funcionalidades de registro y recuperación de contraseña.
- Cambio del entorno APP_SECRET invalida tokens de GitHub almacenados, necesitando reingreso.
- El despliegue con Dockerfile sin montar el volumen /data pierde datos tras redimensionar.
- La autenticación de dominio es necesaria para servicios de correo SMTP externos.
- Almacenamiento de datos crítico en un único volumen Docker que debe respaldarse manualmente.
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.
Recomendado usar Docker Compose (Opción A) para garantizar la persistencia del volumen /data. En despliegues con Dockerfile, es obligatorio montar el volumen 'obi-data' en /data para evitar pérdida de datos tras redimensionar. Configurar APP_SECRET siempre en producción. Es necesario configurar SMTP para permitir registro y recuperación de contraseñas. El puerto 3000 debe exponerse al dominio público.
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.