¿Qué es Joplin AI Agent?
Joplin AI Agent es un plugin comunitario para Joplin, la aplicación de notas de código abierto multiplataforma, desarrollado por el desarrollador independiente HugoValim y distribuido como software de código abierto bajo licencia MIT. Según su propio repositorio de GitHub, añade un agente de IA con acceso de lectura y escritura basado en herramientas a notas, libretas y archivos de texto dentro de un perfil de Joplin, con cada cambio propuesto pasando por un paso de revisión antes de aplicarse.
- ID de plugin:
com.hugovalim.joplin-ai-agent - Versión 0.7.0 al momento de esta reseña: consulta el repositorio directamente para la versión actual, ya que las versiones del plugin cambian de forma independiente a este artículo
- Función principal: un agente de chat en el panel lateral que puede buscar, leer y —tras tu revisión— editar notas, libretas y archivos de texto dentro de tu perfil de Joplin
- Inferencia local: sin motor de inferencia integrado; el plugin envía solicitudes a un servidor compatible con OpenAI que se ejecuta por separado (Ollama, LM Studio o una API en la nube) en lugar de incluir él mismo los pesos del modelo
- Desarrollador: HugoValim, un desarrollador independiente que distribuye el plugin como software de código abierto, sin afiliación con los mantenedores de Joplin
- Repositorio canónico: github.com/HugoValim/joplin-ai-plugin
¿Qué puedes hacer con Joplin AI Agent?
Joplin AI Agent combina chat consciente de tu bóveda de notas, acceso a archivos basado en herramientas, y un paso de revisión antes de cualquier escritura, según su propio README.
- Historiales de chat persistentes — las conversaciones conservan ajustes de contexto y resúmenes de ejecución entre sesiones, en lugar de reiniciarse con cada chat nuevo
- Búsqueda opcional de notas (RAG) — búsqueda semántica sobre tus notas para que las respuestas usen el contenido de la bóveda como contexto; esta función específica requiere Joplin 3.7 o superior
- Reglas contra inyección y fabricación — el plugin documenta reglas diseñadas para prevenir la inyección de prompts a través del contenido de las notas y reducir citas fabricadas cuando el agente escribe sobre tus notas
- Acceso de lectura/escritura basado en herramientas — el agente puede leer y proponer cambios a notas, libretas y archivos de texto plano, no solo hablar sobre ellos
- Propuestas de cambio sujetas a revisión — cualquier cambio propuesto se muestra como un documento diff temporal antes de aplicarse, de modo que apruebas o rechazas el cambio exacto en lugar de que se escriba en silencio
- Detección de conflictos basada en marcas de tiempo — el plugin verifica las marcas de tiempo de modificación de las notas antes de aplicar un cambio, para detectar ediciones concurrentes
- Historial de deshacer — conserva hasta diez ejecuciones durante un máximo de siete días, de modo que un mal cambio hecho por el agente pueda revertirse después
- Interfaz de panel lateral con atajos de teclado — el panel de chat vive en el panel lateral de Joplin con atajos de teclado y pagina los historiales largos a 100 mensajes por página
- Soporte para espacio de trabajo en carpeta externa — puede trabajar con archivos en una carpeta externa fuera del perfil de Joplin, respetando el
.gitignorede esa carpeta
¿Cómo conectar Joplin AI Agent a un modelo local?
Joplin AI Agent se comunica con cualquier endpoint HTTP/SSE compatible con OpenAI: no hay ningún SDK propietario que configurar. La URL base predeterminada, http://localhost:11434/v1, coincide con el puerto de servidor local predeterminado de Ollama, por lo que una instalación estándar de Ollama funciona sin cambiar ninguna URL.
URL base
Clave de API
- Qué introducir:
- Opcional en la mayoría de servidores locales; obligatoria en proveedores en la nube que la exijan.
Nombre del modelo
- Qué introducir:
- El identificador exacto del modelo según lo reporte tu backend (por ejemplo, una etiqueta de modelo de Ollama que ya hayas descargado).
Prompt de sistema, temperatura, tokens de salida, tiempo de espera
- Qué introducir:
- Campos opcionales para ajustar el comportamiento del agente: déjalos en sus valores predeterminados salvo que tengas una razón concreta para cambiarlos.
Toda la configuración se encuentra en Joplin Ajustes → "Joplin AI Agent". Como el plugin usa un protocolo genérico compatible con OpenAI en lugar de llamar a un SDK específico de un proveedor, cualquier servidor local o autoalojado que exponga esa misma forma de API debería funcionar cambiando solo la URL base.
Obtener Joplin AI Agent
Joplin AI Agent se instala como un plugin dentro de Joplin, no como una aplicación independiente: Joplin debe estar ya instalado. Al momento de esta reseña, no se ha confirmado que el plugin aparezca en la búsqueda de plugins comunitarios integrada en Joplin, así que instálalo manualmente desde el archivo .jpl publicado en GitHub Releases.
Instalación manual desde GitHub Releases (recomendado)
- Cómo instalar:
- Descarga
com.hugovalim.joplin-ai-agent.jpldesde la página de GitHub Releases. En Joplin, abre Ajustes → Plugins, usa la opción "Instalar desde archivo" y selecciona el archivo.jpldescargado. Reinicia Joplin si se te solicita, y luego activa el plugin si no está ya activo.
Compilar desde el código fuente
- Cómo instalar:
- Clona github.com/HugoValim/joplin-ai-plugin y sigue las instrucciones de compilación del propio repositorio: útil si necesitas un commit específico o quieres contribuir con cambios.
Requiere Joplin 3.6 o superior. Joplin AI Agent es exclusivo de escritorio: no admite explícitamente las aplicaciones móviles de Joplin, así que instálalo solo en una instancia de escritorio de Joplin en Windows, macOS o Linux.
¿Cómo protege Joplin AI Agent tus notas al escribir?
Cualquier cambio en una nota o archivo que proponga Joplin AI Agent aparece primero como un documento diff temporal, no como una edición silenciosa. Revisas el cambio exacto antes de decidir si aplicarlo: el agente no sobrescribe una nota por su cuenta.
- Escritura basada en diff primero — un cambio propuesto se renderiza como un documento diff temporal que muestra exactamente qué cambiaría, antes de aplicarse a la nota real
- Detección de conflictos basada en marcas de tiempo — el plugin verifica la marca de tiempo de última modificación de una nota antes de aplicar un cambio, para detectar casos en los que tú u otro dispositivo modificasteis la nota después de que el agente la leyera
- Ventana de deshacer — hasta diez ejecuciones permanecen recuperables durante un máximo de siete días, de modo que un cambio no deseado pueda revertirse después, no solo rechazarse antes de aplicarse
- Reglas contra inyección y fabricación — según su propia documentación, aplica reglas destinadas a prevenir la inyección de prompts a través del contenido de las notas y a reducir citas fabricadas cuando el agente hace referencia a tus notas
¿Quién debería usar Joplin AI Agent?
Que Joplin AI Agent encaje depende de si ya usas Joplin como tu aplicación de notas y quieres un agente de IA que pueda leer y, tras revisión, editar esa bóveda usando un backend que tú controlas.
Usa Joplin AI Agent si
- Ya guardas tus notas en Joplin y quieres un agente de IA que pueda buscar, leer y proponer cambios directamente dentro de esa bóveda
- Quieres ejecutar el agente por completo contra un modelo local mediante Ollama o LM Studio, sin cuenta en la nube ni facturación por mensaje
- Quieres ver cada cambio propuesto como un diff antes de que toque tus notas, en lugar de confiar en que un agente escriba en silencio
- Usas Joplin en escritorio (Windows, macOS o Linux); el modo agente no necesita funcionar en móvil para tu flujo de trabajo
- Te sientes cómodo instalando manualmente un archivo
.jpldesde GitHub Releases en lugar de una instalación de un clic desde un mercado
Espera, o busca otra opción, si
- No usas Joplin como tu aplicación de notas: este plugin solo funciona dentro de Joplin
- Necesitas que el agente de IA funcione en Joplin móvil: es exclusivamente de escritorio
- Necesitas hoy la búsqueda de notas (RAG) y usas Joplin 3.6: esa función específica requiere Joplin 3.7 o superior
- No te sientes cómodo dependiendo del plugin comunitario de un único desarrollador independiente para un flujo de trabajo que no puedes permitirte perder: comprueba la actividad de mantenimiento actual del plugin directamente en GitHub antes de confiar en él
Competidores y alternativas
Joplin AI Agent compite más directamente con otros plugins de agente de IA creados para una aplicación de notas específica en lugar de una interfaz de chat independiente. La comparación de PromptQuorum publicada más cercana hoy es para una aplicación anfitriona distinta.
- Reseña de Copilot for Obsidian — un plugin de agente de IA de la misma categoría, pero para Obsidian en lugar de Joplin. Comparte la misma idea central (un agente de IA que lee y edita tu bóveda de notas, con soporte para modelos locales), útil para comparar cómo dos aplicaciones de notas distintas abordan el mismo problema.
- Review de Smart Connections — un tipo de herramienta distinto dentro de la misma categoría más amplia de "IA dentro de tu aplicación de notas": un plugin de búsqueda semántica y descubrimiento de enlaces local para Obsidian, no un agente que edita archivos.
Errores comunes al evaluar Joplin AI Agent
La mayor parte de la confusión sobre Joplin AI Agent viene de asumir que es una función oficial de Joplin, o de esperar que funcione igual en móvil que en escritorio.
Error 1: asumir que Joplin AI Agent es un producto oficial de Joplin
Joplin AI Agent es un plugin comunitario desarrollado y mantenido de forma independiente por el desarrollador HugoValim. No está desarrollado ni publicado oficialmente por los mantenedores de Joplin.
Error 2: esperar una instalación de un clic desde un mercado
Al momento de esta reseña, no se ha confirmado que el plugin sea buscable dentro del catálogo integrado de plugins comunitarios de Joplin. Instálalo manualmente: descarga el archivo .jpl desde GitHub Releases y usa la opción Ajustes → Plugins → "Instalar desde archivo" de Joplin.
Error 3: esperar que funcione en Joplin móvil
Joplin AI Agent no admite explícitamente las aplicaciones móviles de Joplin. Es exclusivo de escritorio, según su propio repositorio.
Error 4: asumir que la búsqueda de notas (RAG) funciona en cualquier versión de Joplin
La búsqueda semántica opcional sobre notas requiere Joplin 3.7 o superior. En Joplin 3.6 (el mínimo indicado por el plugin), el resto de funciones funciona, pero no esta función de búsqueda específica.
Preguntas frecuentes
¿Qué es Joplin AI Agent?
Joplin AI Agent es un plugin desarrollado por la comunidad para la aplicación de notas Joplin que añade un agente de chat con IA con acceso de lectura basado en herramientas y, tras revisión, de escritura a tus notas, libretas y archivos de texto. Está desarrollado de forma independiente por HugoValim.
¿Funciona Joplin AI Agent con modelos de IA locales?
Sí. Se conecta a cualquier endpoint HTTP/SSE compatible con OpenAI, y su URL base predeterminada (http://localhost:11434/v1) coincide con el servidor local de Ollama, por lo que funciona con un modelo totalmente local sin cambios de código. También funciona con LM Studio u otro servidor compatible con OpenAI cambiando la URL base.
¿Está hecho Joplin AI Agent por el equipo de Joplin?
No. Es un plugin comunitario independiente desarrollado y mantenido por HugoValim, no desarrollado ni respaldado oficialmente por los mantenedores de Joplin.
¿Bajo qué licencia se publica Joplin AI Agent?
MIT, según el repositorio de GitHub del plugin en github.com/HugoValim/joplin-ai-plugin.
¿Cómo instalo Joplin AI Agent?
Descarga el archivo com.hugovalim.joplin-ai-agent.jpl desde la página de GitHub Releases del plugin, luego en Joplin abre Ajustes → Plugins y usa "Instalar desde archivo" para seleccionarlo. No se ha confirmado que sea buscable dentro del mercado de plugins integrado en Joplin, por lo que esta instalación manual es la vía documentada.
¿Funciona Joplin AI Agent en Joplin móvil?
No. El plugin no admite explícitamente Joplin móvil: es exclusivo de escritorio, para instalaciones de Joplin en Windows, macOS y Linux.
¿Qué versión de Joplin requiere Joplin AI Agent?
Joplin 3.6 o superior para el plugin en sí. Su función opcional de búsqueda de notas (RAG) requiere específicamente Joplin 3.7 o superior.
¿Edita Joplin AI Agent mis notas automáticamente?
No. Cada cambio propuesto se muestra como un documento diff temporal para tu revisión antes de aplicarse: el agente no escribe en una nota de forma silenciosa.
¿Puedo deshacer un cambio hecho por Joplin AI Agent?
Sí. El plugin conserva hasta diez ejecuciones durante un máximo de siete días, por lo que un cambio reciente hecho por el agente puede revertirse después.
¿Qué backends de IA admite Joplin AI Agent?
Según su propia documentación, cualquier endpoint HTTP/SSE compatible con OpenAI: esto incluye Ollama (predeterminado), LM Studio y la API de OpenAI, ya que usa una forma de API genérica en lugar de un SDK específico de un proveedor.