Sobre el proyecto

EdgeEver es un espacio de trabajo moderno y de código abierto para notas y bases de conocimiento que revive el apreciado diseño de tres paneles al estilo Evernote, a la vez que ofrece una arquitectura de datos abierta e integración perfecta con Agentes de IA para lograr propiedad total y productividad inteligente. ## Por qué EdgeEver Muchos usuarios veteranos de Evernote simplemente quieren una base de conocimiento personal confiable, abierta y rápida. Todas las soluciones principales existentes presentan compensaciones: - **Evernote**: Sobrecargado con anuncios comerciales, exportación de datos engorrosa, niveles gratuitos restringidos y funciones de IA/MCP costosas. - **Obsidian**: Núcleo de código cerrado, sincronización oficial de pago y pesado para capturas ligeras. - **Memos y Stream Notes**: Los diseños de línea de tiempo social difieren de la productividad estructurada. - **SiYuan y PKM basados en bloques**: La arquitectura granular a nivel de bloque añade carga cognitiva y carece de un verdadero nivel sin servidor de costo cero. **EdgeEver llena este vacío**: Todo el stack es de código abierto, incluida la sincronización y el autoalojamiento. Mantiene el diseño de tres paneles, se mantiene fluido con más de 10.000 notas y ofrece agentes de IA nativos con despliegue sin costo. ## Características - **Despliega a tu manera**: Ejecuta en la plataforma sin servidor gratuita de Cloudflare o con Docker en un VPS, NAS o servidor doméstico. El despliegue personal puede albergar aproximadamente 150.000 notas cortas y 50.000 imágenes en Cloudflare; Docker escala según demanda. - **Datos abiertos, sin dependencia de proveedor**: Construido sobre SQLite estándar con API REST completa, MCP y acceso por CLI. - **Respaldo ZIP sin pérdidas y portabilidad**: Exporta tu biblioteca completa como un archivo limpio que contiene Markdown, Front Matter, carpetas anidadas, enlaces relativos a adjuntos e historiales de versiones. - **Sinergia nativa con Agentes de IA**: La integración profunda con Model Context Protocol (MCP) permite que Agentes de IA como Claude Code, Codex, Antigravity y WorkBuddy lean, organicen y resuman notas, o se sincronicen con Notion y Feishu Bitable. - **Trae tus propios modelos de IA**: Conecta servicios compatibles con OpenAI, Anthropic o Gemini para resumen inteligente, extracción de puntos clave, corrección, traducción y continuación de texto. - **API de plugins enriquecida**: Extiende EdgeEver con una API de plugins. - **Sincronización multidispositivo ilimitada**: Sin límites comerciales de dispositivos ni muros de pago. Sincroniza entre PC, tableta y móvil mediante web, PWA o navegador. - **Diseño clásico de tres paneles y modo enfoque**: Árboles de cuadernos, listas de notas y un editor amplio con un modo enfoque de escritorio. - **Rendimiento de escritorio ligero y duradero**: Cambiar de nota no mantiene imágenes y documentos antiguos en memoria. - **Cuadernos anidados ilimitados**: Organiza el conocimiento con profundidad de carpetas arbitraria. - **Copia enriquecida con un clic para boletines y blogs**: Convierte notas en texto enriquecido formateado con CSS en línea para Substack, Medium, WordPress o editores de boletines. - **Editor de doble vista perfecto**: Cambia entre edición de texto enriquecido y código fuente Markdown en escritorio. - **Exportación conveniente de una sola nota**: Exporta como Markdown, HTML o PDF. - **Renderizado nativo de diagramas Mermaid**: Renderiza diagramas de flujo, diagramas de secuencia y mapas mentales directamente en las notas. - **Notas de diagramas visuales**: Dibuja mapas mentales, diagramas de flujo y diagramas de arquitectura directamente en las notas con diseño automático inteligente y exportación vectorial. - **Historial de revisiones**: Inspecciona y restaura iteraciones anteriores de las notas. - **Compartir notas públicamente**: Comparte notas públicamente con contraseñas de acceso autogeneradas opcionales. - **Recorte de artículos de WeChat en móvil**: Extrae contenido de artículos de cuentas oficiales de WeChat. - **Compresión inteligente de imágenes local**: La compresión WebP del lado del cliente reduce el tamaño de los archivos entre un 50 % y un 90 %. - **Adjuntos de archivos universales**: Adjunta y previsualiza PDF, documentos de Office, archivos zip, audio y video; las cargas por fragmentos admiten archivos de hasta 1 GiB. - **Operaciones por lotes y ordenación flexible**: Fusiona o reubica varias notas con reordenación de cuadernos mediante arrastrar y soltar. - **Borradores y colas sin conexión**: Redacta y edita sin conexión; los cambios se sincronizan al reconectarse. - **Protección contra ataques de fuerza bruta**: Limitación del lado del servidor de inicios de sesión fallidos por cuenta y por IP. - **Aislamiento de cuentas multiinquilino**: Aloja varias cuentas de usuario en una sola instancia con espacios estrictamente particionados. - **Donde lo necesites**: Disponible en Web, Android, macOS, Windows, Linux e iOS; Web Clipper es compatible con Chrome, Edge y Firefox. ## Despliegue ### Opción A: Desplegar con un Agente de IA (Recomendado) Copia un prompt en un Agente de IA (como Codex, Claude, Cursor, WorkBuddy, Antigravity, etc.) para desplegar EdgeEver completamente a través de GitHub y Cloudflare. El agente bifurca el repositorio, crea recursos D1 y R2, crea un Worker, establece la contraseña de administrador y habilita las actualizaciones automáticas. ### Opción B: Despliegue manual en línea Completa la configuración en 6 pasos web: bifurca el repositorio, crea recursos de Cloudflare, importa y configura el proyecto, elige una contraseña de administrador, compila y verifica, y habilita las actualizaciones automáticas. ### Opción C: Docker en un VPS o NAS Usa el instalador alojado en GitHub: ```sh curl -fsSL https://edgeever.org/install.sh | bash ``` El comando descarga la última imagen, genera una contraseña de administrador, inicia EdgeEver con Docker Compose y programa actualizaciones automáticas diarias. ## Inicio de sesión multicuenta Una sola instancia admite el inicio de sesión multicuenta. El administrador de la instancia puede crear, deshabilitar o restablecer cuentas de miembros. Cada miembro obtiene un espacio de trabajo personal totalmente aislado. ## Web Clipper para navegador El Web Clipper se publica oficialmente para Chrome, Microsoft Edge y Firefox. ## Comunidad y comentarios - Errores, solicitudes de funciones y problemas de despliegue: GitHub Issues - Contribuciones de código: lee la Guía de contribución - Únete al grupo de Telegram de EdgeEver para debatir sobre aplicaciones de Agentes de IA y flujos de trabajo de automatización. ## Plugins y temas Las aplicaciones web y de escritorio admiten plugins funcionales y temas personalizados, instalables desde el mercado oficial, GitHub o una URL de Manifest. Los desarrolladores pueden ampliar las capacidades usando `@edgeever/plugin-api`. ## Stack tecnológico - Monorepo de espacio de trabajo Bun con Web, API, sitio oficial y paquete de tipos compartidos. - Frontend: Vite, React, React Router, TanStack Query, Tailwind CSS, shadcn/ui y Radix UI. - Editor: TipTap / ProseMirror con soporte de Markdown; la PWA usa vite-plugin-pwa, Workbox y Dexie. - Aplicación Android: Expo + React Native con almacenamiento local SQLite y sincronización incremental. - Aplicación iOS: SwiftUI nativo (iOS 17+), con un EditorBundle TipTap empaquetado, espejo local/outbox GRDB. - Aplicación de escritorio nativa: Electron + sidecar Rust para servicios de datos locales de alto rendimiento. - Web clipper: Manifest V3, Mozilla Readability y Turndown. - Backend: aplicación de negocio Hono/Zod con API REST y MCP remoto; Cloudflare usa Workers/D1/R2, mientras que Docker usa Bun/SQLite/archivos locales o S3. - Sitio oficial: sitio estático Astro desplegable en Cloudflare Pages. ## Inicio rápido ```sh bun install bun run dev ``` El desarrollo local inicia sesión automáticamente; las bases de datos nuevas usan `owner` / `edgeever-local-dev`. ## Formatos de contenido EdgeEver almacena el contenido de las notas en tres formas: `content_json` (documento TipTap/ProseMirror), `content_markdown` (formato de API, Agente, importación y exportación) y `content_text` (texto de búsqueda, resumen e indexación). ## MCP Crea un token de API en Perfil -> configuración de MCP y entrégalo a tu Agente de IA. El Agente puede gestionar de forma segura tu base de conocimiento dentro de los permisos de tu cuenta, admitiendo notas de texto y notas de diagramas con capacidades CRUD completas, además de conexiones a bases de datos de Notion y Feishu Bitable. ## Compresión de imágenes La compresión de imágenes ocurre en el cliente Web antes de la carga. Los archivos PNG, JPEG, WebP y AVIF se convierten a WebP cuando resulta beneficioso, con el lado más largo limitado a 2560 px. ## Almacenamiento de objetos avanzado El propietario de la instancia puede configurar almacenamiento de objetos compatible con S3 en Configuración -> Avanzado -> almacenamiento de objetos OSS. ## Migración Hay guías de migración disponibles para Evernote, flomo, Memos y Notion. ## Despliegue con Docker Docker ejecuta el mismo frontend, rutas de API, servicios, autenticación, implementación de MCP y migraciones que Cloudflare. El contenedor usa SQLite con archivos locales o almacenamiento de adjuntos compatible con S3 y admite `amd64` y `arm64`. ## Sincronización Web, PWA y escritorio suben las ediciones de notas después de 30 segundos de inactividad y buscan cambios remotos cada 5 minutos mientras están visibles; el enfoque y la actualización manual siguen siendo inmediatos. ## Agradecimientos El diseño del producto de toma de notas de EdgeEver se basó en las experiencias de producto disponibles públicamente de herramientas de toma de notas maduras como Evernote. Las funciones relacionadas fueron diseñadas e implementadas de forma independiente por EdgeEver.