Para instalar Onyx Lite con Ollama basta un comando: en menos de dos minutos tienes una alternativa open source a ChatGPT en tu máquina, con un modelo local y unos 1,2 GB de RAM en uso. Con su CLI, Claude Code puede responder preguntas a partir de tus propios documentos. Lo probamos en un Mac con un modelo de 9B, sin gastar nada en APIs.
yoDEV Tested · 23 de octubre de 2026
Instalamos Onyx Lite v4.9.4 con onyx-cli 1.4.4 en un Mac con Apple Silicon, lo conectamos a Ollama conqwen3.5:9by consultamos un documento escrito por nosotros desde Claude Code 2.1.305. Los resultados que reportamos como nuestros salen de esa prueba.
¿Qué es Onyx, la alternativa open source a ChatGPT?
Onyx es la capa de aplicación para LLMs: una interfaz al estilo ChatGPT que alojas tú mismo. Incluye chat, agentes personalizados, subida de documentos, búsqueda web, ejecución de código y acciones vía MCP. Funciona con proveedores en la nube (Anthropic, OpenAI, Gemini) y con modelos locales (Ollama, vLLM, LiteLLM). Antes se llamaba Danswer y tiene 32.900 estrellas en GitHub. El núcleo, la Community Edition, usa licencia MIT. La Enterprise Edition agrega SSO, RBAC, analítica e historial de consultas.
Viene en dos ediciones:
- Onyx Standard: la plataforma completa, con índice híbrido vectorial y por palabras clave, conectores que sincronizan más de 50 aplicaciones y workers en segundo plano. Pide al menos 10 GB de RAM.
- Onyx Lite: chat, agentes, subida de archivos y Projects. No tiene índice vectorial, conectores ni servidores de modelos. Su mínimo documentado es de 2 GB de RAM.
Este artículo cubre Lite, la versión que puedes correr en un portátil para chatear con tus documentos sin mandarlos a la nube.
¿Cómo instalar Onyx Lite?
Instala la CLI y despliega en modo Lite:
uv tool install onyx-cli
onyx-cli deploy install --lite
(pip install onyx-cli también funciona). El instalador revisa los recursos de tu máquina, pregunta qué versión desplegar, descarga los contenedores y espera hasta que todos los servicios estén sanos. La configuración queda en ~/.config/onyx. En Linux ofrece instalar Docker si falta; en macOS necesitas Docker funcionando de antemano. Nosotros usamos Colima.
En nuestra prueba quedó listo en 1 minuto y 49 segundos, con cinco contenedores: Postgres, la API, el servidor web, nginx y el intérprete de código. Calcula unos 6 GB de disco para las imágenes; solo la del backend pesa 2,87 GB.
La primera cuenta que creas se convierte en la de administrador.
¿Cómo conectar Ollama a Onyx en Docker?
En el Admin Panel, ve a Configuration → Language Models, elige Ollama y haz clic en Fetch Available Models. En nuestra prueba, la URL base apareció ya completada como http://host.docker.internal:11434, que es la dirección que usan los contenedores de Onyx para llegar al Ollama de tu máquina. Funcionó sin cambios.
Con un modelo local, nada sale de tu máquina y no hay factura de API. Con qwen3.5:9b, las respuestas tardaron entre 7 y 44 segundos.
¿Cuánta RAM necesita Onyx Lite?
Alrededor de 1,2 GB en uso. El README dice “menos de 1 GB” (under 1GB memory) y la documentación pide 2 GB como mínimo y 4 GB como recomendado. Lo medimos con docker stats:
| Estado | Los cinco contenedores |
|---|---|
| Recién instalado, en reposo | 979 MiB |
| Tras subir archivos y hacer consultas (110 muestras) | ~1,22 GB, estable |
La mayor parte es del servidor de la API, con unos 830 MiB. O sea, la cifra del README solo se cumple en reposo, y el mínimo de 2 GB de la documentación es la referencia honesta. Una salvedad: nunca ejecutamos código en el intérprete, así que su consumo durante una ejecución no está incluido.
¿Cómo usar Onyx desde Claude Code con un skill?
Con onyx-cli, que trae un skill para agentes de programación. Son tres pasos.
1. Crea un token de acceso personal en User Settings → Accounts & Access → New Access Token.
2. Apunta la CLI a tu servidor:
export ONYX_SERVER_URL=http://localhost:3000
export ONYX_PAT=<tu token>
onyx-cli validate-config
Sin ONYX_SERVER_URL, la CLI se conecta a https://cloud.onyx.app. También puedes ejecutar onyx-cli chat una vez: te pide los dos valores y los guarda en ~/.config/onyx-cli/config.json.
3. Instala el skill en tu proyecto:
onyx-cli install-skill --agent claude-code
Escribe .agents/skills/onyx-cli/SKILL.md y lo enlaza desde .claude/skills/onyx-cli, donde Claude Code busca sus claude code skills. El skill no configura la autenticación: para eso es el paso 2.
Nuestra prueba. Subimos un runbook interno lleno de datos inventados, para que ningún modelo pudiera conocerlos de antemano: una ventana de despliegue, un código de error y su solución. Después le hicimos a Claude Code (Sonnet) una pregunta que solo ese documento podía responder. Cargó el skill por su cuenta, consultó a Onyx y respondió bien las dos partes, citando el documento. Tardó 64 segundos y costó 0,22 USD del lado de Claude; el lado de Onyx corrió con el modelo local.
¿Qué no funciona en Onyx Lite?
Hay tres cosas con las que te vas a encontrar:
onyx-cli searchdevuelve HTTP 501: “This feature requires a vector database”. La búsqueda necesita el índice de Standard. El skill les dice a los agentes que pruebensearchprimero, así que en Lite cada consulta gasta una llamada fallida antes de pasar aask. Claude Code se recuperó sin ayuda.- Los archivos subidos a un Project no son accesibles desde la CLI.
askno tiene opción de proyecto. Adjunta el archivo a un agente y pasa--agent-id, o defineONYX_PERSONA_IDcomo agente por defecto. - No hay indexación. Un archivo subido no se divide en fragmentos: entra completo al contexto del modelo. Sirve para runbooks y especificaciones, no para una wiki entera. Para eso necesitas Standard y sus conectores.
Un detalle si lo usas en scripts: si llamas a onyx-cli ask con la entrada estándar abierta pero sin terminal, se queda esperando datos y nunca envía la pregunta. Redirige la entrada desde /dev/null. A Claude Code no le afectó.
¿Onyx es gratis?
La Community Edition es gratis, con licencia MIT, y cubre chat, RAG, agentes y acciones. Con Ollama tampoco pagas por el modelo. La Enterprise Edition (SSO, RBAC, analítica) es de pago, y Onyx Cloud te deja probarlo sin desplegar nada.
Para quitarlo todo:
onyx-cli deploy uninstall --force
Borra los contenedores, los volúmenes y ~/.config/onyx, incluidos todos tus datos.
¿Y tú? ¿Qué modelo local usas con Ollama para el trabajo de todos los días?
- Archivos en el repo, como CLAUDE.md o AGENTS.md
- Un servidor MCP o una plataforma como Onyx
- Lo copio y pego a mano en cada sesión
- Prefiero otra opción (cuéntanos cuál)
Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.
Relacionado: LM Studio, Ollama o llama.cpp: qué corre de verdad en tu máquina