> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Guía de instalación sin conexión
> Instala Linkly AI y pon en marcha todas las funciones de IA locales en un equipo sin internet (sin conexión / intranet): descarga por adelantado el instalador y el paquete oficial de modelos, llévalos al equipo y sigue los pasos.
La búsqueda, el reconocimiento de texto (OCR), la transcripción de voz (ASR) y la búsqueda semántica de Linkly AI **se ejecutan localmente en tu equipo**: el uso diario no necesita internet. Pero dos pasos del flujo normal de instalación sí dependen de la red: descargar el instalador y la descarga automática de los archivos de modelo de IA (unos 870 MB en total) en el primer arranque.
Si el equipo de destino **no tiene ningún acceso a internet** (entorno sin conexión, intranet corporativa, red aislada), sigue esta página: descarga todo en un equipo conectado, llévalo y realiza la instalación.
Para los archivos de modelo, usa el paquete oficial de esta página. **No descargues archivos de modelo de otras fuentes ni montes la estructura de carpetas a mano**: los archivos de modelo se corrompen con facilidad durante el traslado manual o la recodificación, y las funciones de IA acaban fallando con errores confusos.
## Paso 1: Qué descargar primero
En un equipo **con internet**, descarga estas dos cosas:
1. **El instalador de la aplicación**: elige la plataforma del equipo de destino (Windows / macOS / Linux) en la [página oficial de descargas](https://linkly.ai/#get-started). Se requiere la versión **v0.9.0 o posterior** (las versiones anteriores usan otra estructura de carpetas de modelos y el paquete no les sirve).
2. **El paquete oficial de modelos sin conexión**: un único zip de unos 850 MB con todos los modelos que necesitan el OCR, la transcripción de voz y la búsqueda semántica, más un léeme y una lista de sumas SHA-256.
3. **(Solo si el equipo de destino usa Windows) dos instaladores de runtime del sistema** — sin conexión, el instalador de la aplicación no puede obtenerlos automáticamente de internet:
* [WebView2 Runtime (instalador independiente Evergreen, x64)](https://developer.microsoft.com/microsoft-edge/webview2/#download): Windows 11 y la mayoría de los Windows 10 con Edge ya lo traen; los sistemas empresariales recortados / LTSC pueden no tenerlo — llévalo para que la instalación no se quede atascada
* [Microsoft VC++ 2015–2022 Redistributable (x64)](https://aka.ms/vs/17/release/vc_redist.x64.exe): los componentes de IA local de la aplicación dependen de él; si falta, el instalador intenta descargarlo de internet y falla
linkly-ai-offline-models-20260825.zip · unos 850 MB. Tras descargarlo, guarda el zip tal cual: no abras ni edites nada de su interior.
## Paso 2: Qué copiar al equipo de destino
Con un USB, un disco externo o un recurso compartido interno, copia ambos archivos **tal cual** al equipo sin conexión (el escritorio o cualquier ubicación temporal sirve):
* El instalador de la aplicación (`.exe` / `.dmg` / `.AppImage`, etc.)
* El zip del paquete de modelos (**cópialo entero: no lo extraigas antes para copiar las piezas por separado**)
* (Windows) los instaladores de WebView2 y del runtime de VC++
## Paso 3: Cómo realizar la instalación
* **Windows**: instala **primero** el WebView2 Runtime y el VC++ Redistributable, en ese orden (en los equipos que ya los tienen se omiten sin efectos), y **después** haz doble clic en el instalador de la aplicación y sigue el asistente
* **macOS**: abre el `.dmg` y arrastra Linkly AI a la carpeta Aplicaciones
* **Linux**: instala según tu formato de paquete (para AppImage, dale permiso de ejecución y ejecútalo)
Inicia Linkly AI con normalidad una vez: la aplicación crea automáticamente su carpeta de datos (sin conexión, su intento de descargar modelos fallará; ignóralo). Después sal del todo: clic derecho en el icono L de la bandeja del sistema y elige salir.
Localízala según tu sistema operativo (créala si aún no existe):
Pulsa Win + R para abrir «Ejecutar», pega y confirma con Intro:
```
%APPDATA%\ai.linkly.desktop\data
```
En el Finder, menú **Ir → Ir a la carpeta…** (⌘ + ⇧ + G), pega y confirma con Intro:
```
~/Library/Application Support/ai.linkly.desktop/data
```
```bash theme={null}
mkdir -p ~/.local/share/ai.linkly.desktop/data
xdg-open ~/.local/share/ai.linkly.desktop/data
```
También puedes pulsar **Abrir** junto a **Carpeta de datos** en **Ajustes → Acerca de** y entrar en `data/`.
Extrae el zip del paquete en cualquier lugar: obtendrás una carpeta `models` (junto a dos archivos informativos, `README.txt` y `SHA256SUMS.txt`). Copia la **carpeta `models` completa** dentro del directorio `data` que abriste en el paso anterior; si `data` ya contiene una carpeta `models`, fusiona/sobrescribe.
Al terminar, la disposición final debe coincidir exactamente con la [estructura de carpetas](#estructura-tras-la-instalación) de abajo; por ejemplo, debe existir el archivo `data/models/Qwen3-Embedding-0.6B-Q8_0.gguf`.
Abre Linkly AI y entra en **Ajustes → IA**: la sección de modelos debe aparecer como lista, no esperando una descarga. El OCR (reconocimiento de texto en escaneos e imágenes) y la búsqueda semántica funcionan de inmediato.
La transcripción de audio/vídeo viene **desactivada por defecto**: cuando la necesites, activa **Transcripción de audio** y **Transcripción de vídeo** en **Ajustes → Índice** — la aplicación procesará entonces tus archivos multimedia existentes con el modelo de voz incluido, sin volver a escanear.
## Estructura tras la instalación
Una vez colocada, la carpeta `data/models` debe contener lo siguiente (los nombres de archivo deben coincidir exactamente):
```
models/
├── Qwen3-Embedding-0.6B-Q8_0.gguf ← modelo de búsqueda semántica
├── ocr/
│ ├── .ready ← marcador de listo (viene en el paquete; no lo toques)
│ ├── v6/
│ │ ├── pp-ocrv6_small_det.onnx
│ │ ├── pp-ocrv6_small_rec.onnx
│ │ ├── ppocrv6_dict.txt
│ │ ├── korean_pp-ocrv5_mobile_rec.onnx
│ │ ├── ppocrv5_korean_dict.txt
│ │ ├── latin_pp-ocrv5_mobile_rec.onnx
│ │ └── ppocrv5_latin_dict.txt
│ └── structure/
│ ├── pp-doclayout-m.onnx
│ ├── slanet_plus.onnx
│ └── table_structure_dict_ch.txt
└── asr/
└── sense-voice/
├── model.int8.onnx
└── tokens.txt
```
`ocr/.ready` es un archivo oculto (su nombre empieza por punto) que marca los modelos de OCR como listos. **No lo abras, edites ni vuelvas a crear**: las diferencias de codificación que introducen los editores de texto harán que la aplicación lo rechace. Si sospechas que está dañado, basta con volver a extraer el paquete.
## Resolución de problemas
Casi siempre es una estructura que no coincide. Repasa el árbol de arriba punto por punto, con especial atención a:
* Si el zip se extrajo directamente dentro de `data/models`, creando un doble anidado `data/models/models/...`: sube el contenido de la carpeta `models` interior un nivel
* Que el archivo oculto `ocr/.ready` haya llegado (algunas herramientas de extracción omiten por defecto los archivos que empiezan por punto; en el Finder, ⌘ + ⇧ + . muestra los ocultos)
* Que no haya acabado en otra unidad o en la carpeta de otro usuario
El archivo se corrompió durante la descarga o el traslado. Descarga el paquete de nuevo y prueba con otro USB u otro método de transferencia. El paquete incluye un `SHA256SUMS.txt`: los comandos de su `README.txt` permiten verificar cada archivo y localizar dónde se rompió. No intentes repararlo ni extraerlo parcialmente: los modelos corruptos provocan errores en ejecución mucho más difíciles de diagnosticar.
Una versión nueva puede haber cambiado de modelos. Descarga el paquete sin conexión más reciente y colócalo de nuevo siguiendo el paso 3 de esta página.
Las versiones antiguas usan otra estructura de carpetas de modelos, así que este paquete no les sirve. Consigue el instalador más reciente siguiendo los pasos 1 y 2, actualiza la aplicación y continúa.
## Qué funciona sin conexión
Este paquete cubre los **modelos de IA locales**, no todas las funciones. Una vez instalado:
| Función | Disponibilidad sin conexión |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Indexación, búsqueda de texto completo, lanzador, notas | ✅ Siempre disponible (no necesita modelos) |
| Búsqueda semántica, OCR, transcripción de audio/vídeo | ✅ Cubierto por este paquete |
| Chat de IA (Chatbot) | ❌ Depende de modelos en la nube; puede apuntarse a un endpoint compatible con OpenAI dentro de tu red (p. ej. Ollama / LM Studio en la LAN) — ver la sección de proveedores personalizados de [Servicio de modelos](/docs/es/model-service) |
| Instalación de Agent Skills | ❌ Requiere descarga de internet; no forma parte de este paquete |
| Inicio de sesión, bibliotecas en la nube, actualización automática | ❌ Funciones en la nube |