Conclusiones clave
- Desarrollado por el desarrollador independiente HugoValim como plugin comunitario de código abierto: no es un producto oficial de Joplin
- Licencia: MIT, según el repositorio de GitHub
- Se conecta mediante un endpoint HTTP/SSE genérico compatible con OpenAI —sin SDK propietario— con el puerto local predeterminado de Ollama (
http://localhost:11434/v1) como URL base predeterminada - También funciona con LM Studio o la API de OpenAI cambiando la URL base en los ajustes
- Requiere Joplin 3.6+; exclusivo de escritorio: no admite explícitamente Joplin móvil
- Cada cambio en una nota o archivo se muestra como un documento diff temporal para revisión antes de aplicarse: nada se escribe en silencio
- Deshacer conserva hasta diez ejecuciones durante un máximo de siete días; la concurrencia usa detección de conflictos basada en marcas de tiempo
- La búsqueda semántica opcional sobre notas (RAG) requiere Joplin 3.7+
📍 En una frase
Joplin AI Agent es un plugin comunitario que añade a Joplin un agente de chat con IA sujeto a revisión, conectándose a cualquier endpoint compatible con OpenAI, incluidos servidores Ollama y LM Studio totalmente locales.
💬 En términos simples
Añade dentro de Joplin un panel de chat con IA que puede leer tus notas y, solo tras aprobar un diff mostrado, editarlas. Lo conectas a un modelo que se ejecuta en tu propio ordenador mediante Ollama o LM Studio en lugar de una suscripción en la nube, de modo que tus notas puedan permanecer por completo en tu máquina.
📌Nota: Esta reseña es el complemento en profundidad de la entrada de Joplin AI Agent en el Directorio de Software LLM Local: consulta esa página para ver de un vistazo cómo se compara con decenas de otras herramientas con capacidad de IA local.
¿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.
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.
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.