10 min de lecturaPrimeros pasos

Docker para IA: guía básica de agentes en contenedores

Guía de Docker para agentes de IA, explicada con palabras sencillas: qué son los contenedores, por qué importan, cómo instalar Docker y cómo gestionar los recursos.

Por Dmitrii Kargashin

Publicado el 3 de febrero de 2026 · Actualizado el 28 de septiembre de 2026

Has descargado una herramienta de agentes de IA y, en algún punto de las instrucciones de instalación, dice «requiere Docker».

Docker empaqueta un proceso con una vista controlada de archivos, procesos y redes. Puede reducir el acceso de un agente de IA al resto del sistema, pero hasta dónde llega ese aislamiento depende de la configuración. Las rutas del host montadas con permisos de lectura y escritura aún pueden modificarse, y el acceso privilegiado puede exponer mucho más que los archivos del propio contenedor.

Docker Desktop está disponible para entornos compatibles de macOS, Windows y Linux. El tiempo de instalación y los recursos necesarios dependen del ordenador y de la carga de trabajo.

noHuman Team no necesita Docker. La versión de escritorio actual es compatible con macOS y Windows, como verás más abajo.

Si no programas, ese «requiere Docker» puede frenarte en seco. Docker suena a infraestructura. La infraestructura suena complicada.

En resumen

Los contenedores de Docker aíslan los procesos y el sistema de archivos con funciones del sistema operativo
Los contenedores suelen tener menos sobrecarga que las máquinas virtuales, pero el rendimiento varía según el host, la carga de trabajo y la configuración de Docker Desktop
Docker solo reduce el acceso cuando los montajes, los privilegios, las redes, los secretos y el acceso al demonio están configurados de forma segura
noHuman Team ejecuta cada noHuman como proceso nativo, sin Docker; sus controles de credenciales y aprobación no ofrecen un sandbox del sistema de archivos
Para diagnosticar la carga de trabajo, usa los registros y las métricas de recursos de Docker; no des por hecho que existe un ajuste de memoria universal
No necesitas convertirte en especialista en contenedores, pero sí entender qué monta la herramienta y qué privilegios recibe

La buena noticia: Docker es más sencillo de lo que parece. Solo tienes que instalar una aplicación y entender un concepto. Esta guía explica Docker con palabras claras, te muestra por qué lo usan los agentes de IA, te acompaña en la instalación y te ayuda a resolver los problemas más habituales.

Qué es Docker (con palabras sencillas)

Docker ejecuta procesos empaquetados en contenedores con vistas restringidas del sistema operativo.

Un contenedor tiene su propia vista del sistema de archivos, su espacio de nombres de procesos, su software y su configuración de red. Los contenedores Linux comparten el kernel con el host o con la máquina virtual de Docker Desktop. También pueden ver archivos, dispositivos, servicios y secretos del host que expongas de forma explícita.

Eliminar un contenedor borra su capa de escritura. No deshace los cambios en los archivos del host montados mediante bind mounts, en los servicios externos, en los volúmenes con nombre ni en los datos enviados por la red.

Piensa en los apartamentos de un edificio:

Tu ordenador es el edificio
Cada contenedor de Docker es un apartamento
Los apartamentos comparten electricidad y fontanería (CPU, RAM), pero tienen sus propias cerraduras, muebles y distribución
Las entradas, los suministros y las llaves compartidos representan los montajes, las redes, el kernel y los privilegios; una mala configuración puede comunicar los apartamentos
Puedes añadir o quitar apartamentos sin reformar el edificio

Por qué importa esto para los agentes de IA: un contenedor puede acotar los archivos y servicios disponibles para el código que ejecuta el agente. Los daños solo quedan limitados en la medida en que lo estén los montajes, las credenciales, las redes, las capacidades y las acciones externas.

Contenedores frente a máquinas virtuales

Característica	Máquina virtual	Contenedor
Kernel	Kernel invitado independiente	Kernel compartido del host o de la máquina virtual de Docker Desktop
Sobrecarga típica	Mayor	Menor
Barrera de aislamiento	Por lo general, más sólida	Depende mucho del entorno de ejecución y de la configuración
Compatibilidad	Ejecuta un sistema operativo invitado completo	Empaqueta aplicaciones para un entorno de ejecución de contenedores compatible
Cuándo encaja	Mayor separación entre cargas de trabajo	Empaquetado eficiente y aislamiento de procesos acotado

Los contenedores son útiles para muchas cargas de trabajo de agentes. Usa una máquina virtual o un sandbox más robusto si hay código hostil de por medio o se exige una barrera estricta entre inquilinos.

La postura de noHuman Team sobre Docker

Las primeras versiones de noHuman Team ejecutaban cada agente en un contenedor de Docker. La aplicación nativa actual para macOS y Windows ejecuta un proceso supervisado por agente, con una carpeta de trabajo compartido por el equipo y sin necesidad de Docker. En las conexiones de Claude y ChatGPT gestionadas por la pasarela, los noHumans usan credenciales provisionales y la pasarela local añade la autenticación del proveedor. Los inicios de sesión nativos y las vías alternativas pueden guardar credenciales reales en los archivos de cada noHuman. Los noHumans usan los permisos de tu sistema operativo; las aprobaciones y los presupuestos no ofrecen un sandbox del sistema de archivos. Lee la guía de cuentas de IA para conocer estos límites de acceso.

Instalar Docker Desktop

Docker Desktop es la forma más fácil de poner Docker en marcha. Es una sola aplicación que se encarga de todo.

macOS

Descarga Docker Desktop desde docker.com/products/docker-desktop
Abre el archivo .dmg y arrastra Docker a Aplicaciones
Abre Docker Desktop
Espera a que el icono de Docker en la barra de menús indique «Docker Desktop is running»
Comprueba la instalación: docker --version

Consejo sobre recursos: empieza con los valores predeterminados compatibles de Docker Desktop, ejecuta una tarea representativa del agente y usa las métricas de Docker para ajustar la memoria y la CPU sin dejar sin recursos al host.

Windows

Activa WSL 2: abre PowerShell como administrador, ejecuta wsl --install y reinicia
Descarga Docker Desktop y ejecuta el instalador (deja marcada la opción «Use WSL 2»)
Abre Docker Desktop
Comprueba la instalación: docker --version

Windows Home o Pro: Docker Desktop funciona en ambas; en la edición Home, WSL 2 se encarga de todo.

Linux

# Ubuntu/Debian — Docker Engine (lighter, CLI-only)
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in, then verify:
docker --version

Problemas habituales de Docker y cómo solucionarlos

«Docker daemon is not running»

Solución: abre Docker Desktop. Espera a que el icono de la ballena deje de animarse.

El contenedor se cierra de inmediato

Solución: revisa los registros del contenedor: docker logs <container-name>. En los agentes de IA, la causa más frecuente es que falta una clave de API.

«Port already in use»

Solución: cambia la asignación de puertos en el archivo de Docker Compose: usa 8081:8080 en lugar de 8080:8080.

Los contenedores van lentos

Solución: revisa docker stats, los registros de los contenedores, la presión de memoria del host, la actividad del disco, el uso del navegador y la latencia de red. Ajusta los recursos solo después de identificar el cuello de botella.

La presión de memoria es una de las posibles causas de que los contenedores vayan lentos o se bloqueen. Los procesos del navegador, las compilaciones, la presión sobre el disco, los fallos de red y los bucles de reintentos pueden producir síntomas parecidos, así que revisa primero las métricas y los registros.

«No space left on device»

Solución: consulta el uso con docker system df e identifica qué se puede eliminar sin riesgo. docker system prune borra los datos de Docker sin usar; revisa su mensaje y sus opciones antes de continuar. No recurras a una limpieza periódica fija en lugar de comprobar qué ocupa el espacio.

Gestión de recursos: RAM y CPU para agentes de IA

Los agentes de IA dentro de contenedores de Docker no necesitan recursos enormes: el cálculo pesado se hace en los servidores del proveedor de la API. El contenedor aloja el entorno de ejecución del agente, a veces un navegador y algunas herramientas locales.

Mide la carga de trabajo que vas a ejecutar

El uso de memoria y de CPU de un agente depende del entorno de ejecución, de las pestañas del navegador, de las herramientas de desarrollo, de las tareas simultáneas y de dónde esté el modelo. No hay una asignación universal fiable para un número determinado de agentes.

Ejecuta una tarea representativa y anota:

La memoria máxima y en reposo de cada contenedor
El uso de CPU durante las compilaciones y el trabajo con el navegador
El crecimiento del disco por imágenes, cachés, registros y perfiles
La presión de memoria del host mientras los contenedores están activos
Si los límites de recursos provocan reinicios o trabajos fallidos

Ejecuta docker stats para ver el uso actual de CPU y memoria de cada contenedor. Relaciona un pico con los registros y con la tarea en curso antes de atribuirlo al navegador o de cambiar un límite.

Docker es fontanería, no una habilidad

Este cambio de mentalidad ayuda: no tienes que «aprender Docker». Basta con instalarlo y dejar que las herramientas de IA lo usen.

Docker es fontanería. No hace falta entender el diámetro de las tuberías para usar un fregadero. Un buen entorno de ejecución oculta Docker por completo: configuras los agentes en un panel de control y el entorno de ejecución se encarga de los contenedores. (noHuman Team fue un paso más allá y dejó los contenedores por procesos nativos, de modo que sus usuarios nunca se topan con Docker.) Necesitas saber dónde está la llave de paso (Docker Desktop → Quit), cómo comprobar si hay un atasco (los registros del contenedor) y cuándo llamar al fontanero (Stack Overflow).

Instala Docker Desktop, revisa qué monta la herramienta del agente y a qué puede acceder, y consulta los registros y las métricas cuando algo falle. Aplica las actualizaciones y borra los datos sin usar con criterio.

Preguntas frecuentes

¿Necesito Docker para ejecutar agentes de IA? Depende de la herramienta. Muchos frameworks de agentes de servidor o autoalojados lo usan para empaquetar y aislar procesos. noHuman Team no: es una aplicación nativa para macOS y Windows que ejecuta procesos supervisados, con estado de trabajo y perfiles de navegador independientes. Sus controles de credenciales, aprobación y presupuesto no ofrecen una barrera en el sistema de archivos como la de un contenedor.

¿Cuánta RAM necesita Docker para agentes de IA? No hay una cantidad universal. Influyen el código del entorno de ejecución, los navegadores, las compilaciones, la concurrencia y la sobrecarga de Docker Desktop. Consulta los requisitos actuales del framework, ejecuta una carga de trabajo representativa y usa docker stats junto con las métricas del host para fijar límites que le dejen capacidad suficiente.

¿Qué es un contenedor de Docker, explicado de forma sencilla? Un contenedor de Docker es un proceso empaquetado con su propia vista del sistema de archivos, su espacio de nombres de procesos y su configuración de red. Comparte el kernel con el host Linux o con la máquina virtual de Docker Desktop. Puede afectar a archivos del host y a sistemas externos que expongas mediante montajes, privilegios, credenciales o redes.

¿Es seguro que los agentes de IA usen Docker? Docker puede reducir el acceso de un agente si está reforzado. Revisa los bind mounts, el acceso al socket de Docker, el modo privilegiado, las capacidades, los dispositivos, las redes, los secretos, los límites de recursos y las actualizaciones. Usa una barrera más sólida cuando la carga de trabajo sea hostil o las consecuencias de un escape sean inaceptables.

¿Cómo soluciono que Docker vaya lento con agentes de IA? Revisa docker stats, los registros de los contenedores, la presión de memoria del host, el uso del disco, la latencia de red y los reintentos del agente. Cambia los límites de uno en uno y repite una tarea representativa. Inspecciona los datos sin usar antes de ejecutar un comando de limpieza (prune).

Puntos clave

Docker ofrece un aislamiento de procesos útil, pero hasta dónde protege depende de la configuración
Los contenedores suelen tener menos sobrecarga que las máquinas virtuales; no te fíes de ninguna proporción universal de rendimiento
Los bind mounts, el acceso al socket de Docker, los privilegios, las redes, los dispositivos y los secretos determinan a qué puede acceder el agente
Diagnostica los problemas de recursos con métricas y registros antes de cambiar límites o borrar datos sin usar
Aprende lo suficiente de Docker para entender los montajes, los permisos, la red y la limpieza que hace la herramienta del agente

Instala noHuman Team para tener un equipo nativo en macOS o Windows. La suscripción mensual empieza con una prueba de 7 días; al contratarla se piden los datos de pago. Tu proveedor de IA cobra por separado.

Compartir: X / Twitter