Skip to main content
Esta página reúne las preguntas más comunes de los usuarios de Linkly AI.

​
¿Cómo protege Linkly AI la privacidad de los datos?

Linkly AI utiliza una arquitectura local-first. Los documentos originales, el índice de texto completo, el índice vectorial y la inferencia del modelo de embeddings se ejecutan en tu dispositivo y, por defecto, no se suben a ningún servidor.

​
Qué datos se quedan en local

  • Documentos originales: permanecen en sus carpetas originales. Linkly AI solo los lee — no los copia ni los mueve.
  • Índice de texto completo (BM25): construido localmente con Tantivy.
  • Índice vectorial: los embeddings se guardan en una base de datos local.
  • Modelo de embeddings: un modelo de embeddings local se ejecuta completamente en tu dispositivo; en Apple Silicon se activa automáticamente la aceleración GPU Metal.
  • Registros de la aplicación: solo se escriben en archivos locales y nunca se suben automáticamente.

​
A dónde van los datos del chat con IA

Cuando el chatbot llama a un modelo de lenguaje grande, el flujo de datos depende del provider que hayas elegido:

Modelo local

Ollama, LM Studio u otro servicio local compatible con OpenAI. Los datos se quedan totalmente en tu máquina.

Linkly oficial

Se reenvía a un proveedor de modelos de terceros vía api.linkly.ai. Las solicitudes pasan por los servidores de Linkly.

Tercero directo

Conexión directa a OpenAI, Anthropic, etc. Las solicitudes no pasan por los servidores de Linkly.
Puedes añadir, cambiar o desactivar cada provider en Ajustes → IA.

​
Programa de mejora de la experiencia (telemetría)

Para entender qué funciones se usan y en qué entornos se ejecuta la app, Linkly AI envía por defecto un informe de uso anónimo: Puedes desactivarlo en cualquier momento desde Ajustes → Privacidad → Programa de mejora de la experiencia. Al desactivarlo, los eventos pendientes en memoria también se descartan.
El panel «Privacidad de los datos» de los ajustes muestra con tres tarjetas el flujo de datos de cada función (Local / Nube oficial / Terceros), para que veas de un vistazo qué datos salen de tu dispositivo.

​
Compromiso de privacidad

  • No incluimos SDKs de analítica de terceros (Google Analytics, etc.).
  • No leemos tu historial de navegación ni el portapapeles.
  • No exigimos cuenta — las funciones principales funcionan offline.
  • Los registros de la aplicación se quedan en tu máquina y solo se nos envían si los compartes explícitamente.

​
¿Cuánto tarda en completarse la indexación de Linkly AI?

El tiempo de indexación depende del número de archivos, sus tipos, el rendimiento de la máquina y el modo de indexación. Linkly AI indexa en tres fases:
1

Indexación rápida de nombres (segundos)

En cuanto se detectan archivos, se escriben sus rutas y nombres en el índice de texto completo, para que puedas buscar por nombre incluso mientras se indexa el contenido.
2

Extracción y BM25 (minutos a horas)

El contenido de los documentos (txt, md, html, docx, doc, pptx, xlsx, csv, epub, rtf, pdf, imágenes y, si has activado la transcripción, también audio y vídeo) se analiza; los esquemas y metadatos se escriben en Tantivy. Pueden ejecutarse varios workers en paralelo.
3

Embeddings vectoriales (minutos a horas)

El modelo de embeddings local genera un vector por cada fragmento del documento y lo escribe en el índice vectorial.

​
Factores que afectan a la velocidad

  • Número de archivos: aproximadamente lineal con el tiempo total.
  • Formato de archivo: el texto plano es lo más rápido; los PDF requieren analizar páginas.
  • Rendimiento de la máquina: en Apple Silicon (serie M) la aceleración GPU Metal acelera mucho los embeddings frente a la inferencia en CPU; en Windows / Linux la inferencia se hace actualmente en CPU.
  • Modo de indexación: en Ajustes → Índice puedes elegir Rendimiento / Equilibrado / Automático. Rendimiento usa más concurrencia y más CPU; Automático cambia a Rendimiento cuando el sistema está inactivo.

​
Estimaciones aproximadas

Son solo órdenes de magnitud — el tiempo real varía mucho según el hardware y la mezcla de archivos:
Puedes ver la progresión en tiempo real (indexados / pendientes) en la parte superior del Launcher. La indexación corre en segundo plano y no bloquea la búsqueda — en cuanto termine la indexación de nombres, la búsqueda está disponible.
Si solo estás probando Linkly AI, empieza con una base de conocimiento pequeña (cientos a miles de archivos) y añade directorios más grandes cuando te sientas cómodo.

​
¿Por qué no encuentro un archivo?

Empieza por un triaje: búscalo por su nombre de archivo. Los tres desenlaces posibles corresponden a tres problemas completamente distintos: Este paso es clave: los tres casos se tratan de forma muy distinta, y saltárselo lleva a perder mucho rato buscando en la dirección equivocada.
Los archivos omitidos no se listan en ningún sitio de los ajustes. La insignia en los resultados de búsqueda es la única forma de descubrirlos, así que el triaje de arriba hay que hacerlo uno mismo.

​
Las cuatro causas

Al pasar el ratón por encima de la insignia se da esa misma explicación. Estos archivos siguen apareciendo en los resultados, solo que sin contenido que buscar.

​
Qué son los marcadores de la nube

iCloud Drive, OneDrive, Dropbox o Synology Drive tienen todos una función de descarga bajo demanda (también llamada «solo en línea» o «sincronización inteligente»): el archivo se ve en el Finder o el Explorador, pero su contenido sigue estando en la nube y solo se descarga de verdad cuando lo abres. Linkly AI evita a propósito abrir esos archivos: abrirlos dispararía la descarga, y eso significaría que una sola indexación podría traerse a local cientos de GB de tu nube, llenando el disco y saturando el ancho de banda. Por eso se limita a mirar los atributos y, en cuanto reconoce un marcador, omite el contenido y conserva la indexación del nombre.
Qué hacer: en el cliente de tu servicio en la nube, marca las carpetas que de verdad necesitas buscar como «mantener siempre en este dispositivo» (cada uno lo llama de una forma: OneDrive dice «Conservar siempre en este dispositivo», Dropbox «Hacer local» y en iCloud es «Descargar ahora» con el botón derecho). Una vez que los archivos estén en local, Linkly AI verá en el siguiente escaneo que ya están disponibles y completará solo la indexación del contenido: no hay que reconstruir el índice ni volver a añadir la carpeta.
Los escaneos se disparan solos al arrancar la aplicación, al cambiar la configuración (por ejemplo al añadir o quitar carpetas) y al detectar muchos cambios de archivos. Si quieres provocar uno ya mismo, lo más cómodo es reiniciar la aplicación.

​
Qué hacer si la firma del archivo no coincide

Significa que los bytes característicos de la cabecera del archivo no cuadran con su extensión. Es habitual en archivos alias o stub de ciertas herramientas de sincronización, en descargas interrumpidas a medias, o en archivos a los que alguien cambió la extensión a mano. Ábrelo con el programa correspondiente para comprobarlo: si tampoco se abre ahí, Linkly AI hizo bien en omitirlo; y si lo que pasa es que la extensión está mal escrita, basta con corregirla.
El criterio de Linkly AI aquí es antes dejar pasar que descartar por error: si al leer la cabecera se topa con un error de E/S puntual o un vaivén de permisos, lo trata siempre como «contenido disponible» y nunca marca un archivo real como señuelo por un fallo momentáneo.

​
Aparece por el nombre, sin insignia, pero no encuentro su contenido

Que no haya insignia significa que el archivo en sí está bien: lo que pasa es que el paso de extracción del contenido aún no se ha hecho, o no se puede hacer. De más a menos probable:
  1. El extractor correspondiente está apagado. Las imágenes y los PDF escaneados dependen del Reconocimiento de texto en imágenes (OCR), y el audio y el vídeo de la Transcripción de audio y la Transcripción de vídeo — y estas dos últimas vienen desactivadas por defecto. Compruébalo en Ajustes → Índice.
  2. Todavía no le ha tocado el turno. El OCR y la transcripción de audio y vídeo son las tareas más pesadas, así que es normal que la cola avance despacio. En el detalle de estado de los ajustes se ve qué están procesando en cada momento.
  3. El análisis de ese archivo ha fallado. Por ejemplo, porque está dañado o porque es un PDF cifrado. En ese caso no hay insignia: simplemente se omite y no se reintenta.
  4. Un .doc heredado exportado en macOS todavía no se puede analizar. Los archivos generados por textutil o por la exportación «Word 97» de Pages usan una disposición interna distinta a la de Microsoft Word, así que por ahora se omiten. Vuelva a guardarlos como .docx en Word, o conviértalos a otro formato admitido.

Ajustes de indexación

Para qué sirve cada interruptor, qué valor trae por defecto y qué significa cada fila del detalle de estado: todo está en esta página.

​
Ni siquiera aparece por el nombre del archivo

Esto significa que el archivo no ha entrado en el índice en absoluto. Hay tres causas habituales: Uno: esa carpeta no está vigilada. Ve a Ajustes → Carpetas y comprueba que su carpeta superior está en la lista. La guía del primer arranque solo indexa los ejemplos que trae la aplicación; tus propias carpetas tienes que añadirlas tú. Dos: ese formato no está en la lista de admitidos. Linkly AI trabaja con una lista blanca: solo se recogen las extensiones de PDF, DOCX, DOC, PPTX, XLSX, CSV, EPUB, RTF, Markdown, TXT, HTML, imagen, audio y vídeo. Por ahora htm y avi no están entre ellas, y un archivo fuera de la lista blanca no llega ni a registrar su nombre. La lista completa está en la introducción a las herramientas. Tres: está dentro de una carpeta ignorada. Estas carpetas se omiten enteras, con todas sus subcarpetas:
  • Carpetas ocultas que empiezan por punto (.git, .cache, .dropbox.cache, etc.)
  • node_modules, __pycache__ y demás cachés de compilación o dependencias
  • Carpetas de metadatos de sincronización de NAS: #recycle, #SynoRecycle, @eaDir (Synology), @Recycle (QNAP)
  • Carpetas del sistema: $RECYCLE.BIN, System Volume Information
Dentro de un repositorio Git, los archivos excluidos por .gitignore tampoco se indexan. Si tus notas están justo en una carpeta ignorada de algún repositorio, sácalas de ahí o añade esa carpeta por separado en Ajustes → Carpetas.

​
No encuentro lo que se dice dentro de un audio o un vídeo

Porque la transcripción de audio y la de vídeo vienen desactivadas por defecto. Estando apagadas, los archivos multimedia entran igualmente en el índice (por eso se encuentran por su nombre), pero lo que se dice dentro no se transcribe. Ve a Ajustes → Índice y activa Transcripción de audio y Transcripción de vídeo: la aplicación descargará el modelo de reconocimiento de voz y después completará sola todos los archivos multimedia que ya tenías, sin necesidad de volver a escanear ni de reconstruir el índice.

Ajustes de indexación

Esta página explica para qué sirve cada interruptor de Ajustes → Índice, qué valor trae por defecto y cuál es la ruta completa de diagnóstico cuando la indexación da problemas.

​
¿Puedo usar las funciones de IA en un equipo sin internet (sin conexión / intranet)?

Sí. El OCR, la transcripción de voz y la búsqueda semántica se ejecutan localmente (las funciones en la nube, como el chat de IA y la instalación de Skills, son la excepción); lo único es que los archivos de modelo de los que dependen (unos 870 MB) se descargan normalmente en el primer arranque. En un equipo sin acceso a internet, descarga el instalador y el paquete oficial de modelos sin conexión en un equipo conectado, llévalos en USB e instala paso a paso.

Guía de instalación sin conexión

Qué descargar primero, qué archivos copiar y cómo instalar: el flujo completo en una página.

​
¿Qué hago si la AppImage de Linux no arranca?

Las distribuciones Linux varían mucho en sus bibliotecas básicas, componentes de escritorio y controladores. Una AppImage incluye la mayoría de las dependencias de la aplicación, pero no sustituye glibc, el runtime de C++, FUSE ni los controladores gráficos del sistema operativo, por lo que no puede garantizar que funcione directamente en todas las distribuciones Linux. Linkly AI ofrece AppImage para Linux x86_64 y arm64 (aarch64); ambas requieren glibc 2.35 o superior. Empieza ejecutando estos comandos desde el directorio que contiene la AppImage:
uname -m muestra x86_64 o aarch64; descarga la AppImage correspondiente. El último comando inicia la aplicación y guarda a la vez los errores de la terminal.
La AppImage no tiene permiso de ejecución. Ejecuta:
No inicies Linkly AI con sudo: podría crear archivos de configuración y datos a los que tu usuario normal no pueda acceder después.
Las AppImage normalmente se montan mediante FUSE. Instala la biblioteca de compatibilidad FUSE 2 únicamente desde el repositorio oficial de tu distribución:Si FUSE no está disponible en tu entorno, puedes extraer y ejecutar temporalmente la AppImage:
Este método es más lento y solo evita FUSE; no corrige incompatibilidades de GLIBC, arquitectura de CPU o controladores. Consulta la guía oficial de AppImage para problemas con FUSE.
El runtime básico del sistema operativo es demasiado antiguo y el fallo ocurre antes de que Linkly AI llegue a iniciarse:
  • GLIBC_x.y procede de glibc; el requisito mínimo actual es glibc 2.35.
  • GLIBCXX_x.y y CXXABI_x.y proceden del runtime de C++ del sistema, libstdc++.
Instala primero todas las actualizaciones oficiales que ofrezca tu distribución y reinicia. Si el error continúa, actualiza a una versión más reciente admitida oficialmente por esa distribución. Instalar FUSE o volver a descargar la AppImage no cambiará el resultado.
No sustituyas manualmente /lib/.../libc.so.6, no copies glibc o libstdc++ de otra distribución, no mezcles repositorios de distribuciones diferentes ni fuerces un runtime del sistema descargado mediante LD_LIBRARY_PATH. Estas soluciones pueden dañar el escritorio, el gestor de paquetes o todo el sistema operativo.
El paquete no coincide con la arquitectura de tu CPU. Las AppImage de Linux se publican para x86_64 (Linkly AI_<versión>_amd64.AppImage) y arm64 (Linkly AI_<versión>_aarch64.AppImage); descarga la que coincida con uname -m (x86_64 → amd64, aarch64 → aarch64). Cambiar permisos o instalar bibliotecas no corrige una incompatibilidad de arquitectura.
Suele deberse a la combinación de Wayland / X11, Mesa o controladores gráficos propietarios, portals del escritorio y WebKitGTK. Instala primero las actualizaciones oficiales del sistema y de los controladores gráficos que ofrezca tu distribución. Después, vuelve a iniciar desde una terminal y conserva la salida:
Evita copiar de internet variables desconocidas de WebKit, GTK o gráficos en la configuración permanente: un mismo ajuste puede comportarse de forma diferente según las versiones de WebKitGTK y los controladores. Si sigue sin arrancar, envíanos estos datos de diagnóstico junto con linkly-ai-linux-startup.log:
Actualizar una AppImage requiere sustituir el archivo AppImage actual. Guárdalo en un directorio donde tu usuario pueda escribir, como ~/Applications, y no en un volumen de solo lectura ni en un directorio del sistema propiedad de root:
La documentación puede resolver permisos de ejecución o la falta de FUSE, pero no puede cambiar la versión de GLIBC ni la arquitectura de CPU que exige el binario. Si la aplicación no llega a crear app.log, usa la salida de la terminal guardada en linkly-ai-linux-startup.log.

​
¿Dónde está cada ajuste?

La ventana de ajustes está dividida en páginas por función. Estas son las que más se buscan:
  • Idioma: el idioma de la interfaz
  • Iniciar al iniciar sesión: arranca Linkly AI al entrar en el sistema
  • Inicio silencioso: al arrancar con el sistema se queda solo en segundo plano, sin abrir la ventana principal; viene activado, de modo que la indexación y el servicio MCP funcionan sin molestarte
  • Atajo de búsqueda: el atajo global que muestra u oculta el lanzador; basta pulsarlo para volver a grabarlo, y también se puede Restablecer. Si avisa de que la combinación ya está ocupada o reservada por el sistema, elige otra
  • Espacio de Linkly AI: la carpeta que se indexa por defecto; se puede abrir o cambiar de sitio, ver Espacio de Linkly AI
  • Tema: claro / oscuro / seguir al sistema
  • Tamaño del texto: pequeño / estándar / grande, aplicado a la vez a la interfaz y al chat
  • Mostrar icono en el Dock (macOS): al desactivarlo, la aplicación se queda solo en la bandeja de la barra de menús y no ocupa sitio en el Dock
  • Buscar actualizaciones: comprueba y descarga a mano la nueva versión; cuando termine, pulsa Reiniciar para actualizar
  • Unirse al programa beta: al activarlo recibirás las versiones de desarrollo (beta), con acceso anticipado a las novedades pero también a cambios que aún no están del todo probados
  • Carpeta de datos: donde viven el índice, los ajustes y los registros; el botón Abrir lleva directamente ahí (de ahí se sacan los registros)
  • Desde aquí también se salta al registro de cambios, la política de privacidad, los términos del servicio y la documentación de la CLI y de Skills
Lista todos los atajos de la aplicación. Desde el lanzador se abre directamente esta página pulsando ⌘ + / (en Windows/Linux, Ctrl + /).
Pausar indexación no está en los ajustes: solo aparece en el menú de la bandeja del sistema, y hace falta clic derecho sobre el icono L de la bandeja para desplegarlo (con el clic izquierdo se abre la ventana de chat con IA). Más detalles en Ajustes de indexación.

​
¿Cómo obtengo los registros de ejecución de Linkly AI?

Mientras se ejecuta, la app escribe automáticamente sus registros completos en un archivo local app.log (máx. 2 MB por archivo, con rotación). Adjuntar este archivo al reportar un problema acelera mucho el diagnóstico. Los datos sensibles ya están enmascarados. Hay dos formas de obtener el registro:

​
Opción 1: Abrir desde la aplicación (recomendado)

Es la forma más sencilla:
1

Abrir la página «Acerca de»

En Linkly AI, ve a Ajustes → Acerca de.
2

Abrir el directorio de datos

Localiza la fila «Directorio de datos» y haz clic en el botón «Abrir» de la derecha. El gestor de archivos se abrirá en la carpeta de datos de la aplicación.
3

Sacar app.log del subdirectorio logs

Entra en el subdirectorio logs/ y envíanos app.log.

​
Opción 2: Abrir manualmente el directorio de datos

Si la app ha fallado o no arranca, abre la carpeta directamente desde el disco:
  1. Abre Finder.
  2. En la barra de menús, elige Ir → Ir a la carpeta… (o pulsa ⌘ + ⇧ + G).
  3. Pega esta ruta y pulsa Intro:
  4. Encuentra app.log en la carpeta y envíanoslo.

​
¿Qué hacer si la app falla al iniciar?

Si la app se cierra de inmediato al iniciar, app.log puede no haber tenido tiempo de escribirse. En ese caso guardamos la información del fallo en un registro de fallo de inicio aparte linkly-ai-startup-panic.log. Búscalo en la ruta de abajo.
  1. Abre Finder.
  2. En el menú superior elige Ir → Ir a la carpeta… (o pulsa ⌘ + ⇧ + G).
  3. Pega la ruta de abajo y presiona Enter:
  4. Encuentra linkly-ai-startup-panic.log en la carpeta y envíanoslo.
Este registro solo se crea cuando ocurre un fallo durante el inicio, y cada fallo sobrescribe el anterior. Si este archivo tampoco existe, manda una captura de la ventana o diálogo del fallo junto con la versión de tu sistema.

Dónde enviarlo

Abre un issue en GitHub o contáctanos por cualquier canal de la página de comunidad.