Guía para construir una fuerza laboral de IA completamente local con Eigent

Si buscas desplegar potentes herramientas de IA, probablemente te hayas enfrentado a un desafío clave: cómo desbloquear todo su potencial sin comprometer la seguridad de tus datos sensibles.

La mayoría de las plataformas envían todo a la nube, algo que al principio parece conveniente, pero rápidamente genera señales de alerta cuando trabajas con registros de clientes, datos financieros o propiedad intelectual interna. Quieres la potencia de los sistemas multi-agente, pero también quieres privacidad, control y la capacidad de ejecutar todo en tu propia máquina.

Ahí es donde entra Eigent — con Eigent open source cowork, puedes construir una fuerza laboral multi-agente completamente local que vive íntegramente en tu propia infraestructura.

¿Qué es Eigent?

Eigent es una aplicación de escritorio multi-agente con enfoque local primero. En lugar de enviar tus datos a servidores externos, ejecuta todo en tu ordenador. Obtienes visibilidad total de lo que ocurre y la confianza de que tus archivos, credenciales y registros permanecen contigo.

Piensa en ello como construir tu propia fuerza laboral de IA. Puedes iniciar distintos agentes, cada uno con sus propias habilidades: un agente de búsqueda que rastrea la web, un agente desarrollador que ejecuta código, un agente documental que escribe y edita archivos, e incluso agentes multimodales que manejan imágenes y audio. Eigent los coordina por ti para que puedan abordar tareas en paralelo, delegarse trabajo cuando sea necesario y entregar resultados pulidos.

En esta guía te mostraremos exactamente cómo configurarlo localmente. Al final tendrás Eigent funcionando en tu escritorio con agentes listos para trabajar juntos bajo tus condiciones.

Requisitos previos

Node.js (v18 o posterior) y npm: Eigent es una aplicación Node/Electron. Instala Node.js (se recomienda 18–22) si aún no lo has hecho. Memoria y hardware: Se recomiendan al menos 8 GB de RAM. Eigent puede ejecutarse completamente en CPU si te conectas a APIs externas. Para la inferencia local de modelos grandes, una GPU potente (por ejemplo, NVIDIA RTX) ayudará. Sistema operativo: Eigent es compatible con Windows y macOS. Docker: Instala Docker y asegúrate de que esté en ejecución. https://docs.docker.com/get-docker/ ‍

1. Clona el repositorio e inicia el backend de PostgreSQL

Clona el repositorio de Eigent e instala las dependencias:

git clone https://github.com/eigent-ai/eigent.git
cd eigent

Cambia al directorio del servidor e inicia Docker:

cd server
cp .env.example .env
docker compose up -d

Esto levanta dos contenedores:

Una base de datos PostgreSQL (almacén de datos de Eigent) El servidor API de Eigent Ambos se ejecutan localmente en tu máquina, con localhost:3001 para la API. De forma predeterminada, Docker creará un volumen para PostgreSQL, de modo que los archivos de la base de datos se almacenan en disco.

2. Verifica el almacenamiento local de datos

En este punto, todo se está ejecutando localmente. El contenedor de PostgreSQL (eigent_postgres) contiene la base de datos. Puedes comprobarlo listando tus contenedores de Docker o usando una herramienta como psql dentro del contenedor. Todo lo que hace Eigent (mensajes de agentes, datos de usuario, registros de tareas, etc.) se escribirá en esa instancia local de Postgres. No se envían datos fuera de tu máquina.

Todos los datos de Eigent se almacenan en la base de datos local de PostgreSQL ejecutada en Docker.

Esto garantiza la privacidad por diseño. Como se indica en la documentación, una ventaja clave del autoalojamiento es la privacidad de los datos: mantienes la información sensible dentro de tu propia infraestructura. De hecho, cuando usas esta configuración, ninguna información del espacio de trabajo ni de inicio de sesión sale nunca de tu red local. Eigent es completamente local por defecto, así que puedes auditar y confiar en que tus datos permanecen donde están.

3. Modifica .env.development para el proxy local

A continuación, necesitamos indicar al frontend que use el backend local en lugar de cualquier servicio en la nube. En la raíz del proyecto (eigent/.env.development), habilita la configuración del proxy local. Abre .env.development en un editor de texto y asegúrate de que contenga:

VITE_BASE_URL=/api
VITE_PROXY_URL=http://localhost:3001
VITE_USE_LOCAL_PROXY=true

Al establecer VITE_USE_LOCAL_PROXY=true y apuntar VITE_PROXY_URL a http://localhost:3001, configuras el frontend para enviar todas las llamadas API a tu backend local en Docker.

Asegúrate de eliminar cualquier # inicial o marcador de comentario en esas líneas para que surtan efecto. Con esta configuración, la app frontend enviará las solicitudes por proxy a tu servidor local en lugar de a la API de demostración externa.

4. Ejecuta la aplicación frontend

Ahora vuelve a la raíz del repositorio e instala las dependencias de JavaScript; luego inicia el servidor de desarrollo:

cd ..
npm install
npm run dev

Esto iniciará el frontend de Eigent localmente. De forma predeterminada se ejecuta en http://localhost:3000. Con los cambios en .env, el frontend se conectará a la API en http://localhost:3001 — todo dentro de tu máquina.

> eigent@* dev
> vite

  VITE vX.X.X  ready in Y ms

  ➜  Local:   http://localhost:3000/

No se necesitan credenciales especiales de la nube aquí — es simplemente una compilación normal de desarrollo de Node.

5. Accede a la interfaz de usuario de Eigent localmente

La pantalla de inicio de sesión de Eigent se cargará, servida localmente. Aunque se requiere iniciar sesión, esta instancia está autoalojada y no interviene ningún servicio externo.

Este inicio de sesión es solo para la app local: tus credenciales y datos se guardan en la base de datos local de Postgres que iniciaste, no en algún servidor en la nube. Aunque la interfaz presenta un inicio de sesión de estilo OAuth, toda la autenticación y los datos de usuario residen en tu máquina. La documentación destaca esta configuración local primero: “Tus datos permanecen en tu propio dispositivo, abordando las preocupaciones de privacidad y seguridad”. Una vez que inicies sesión, llegarás al panel principal donde podrás crear agentes personalizados, definir flujos de trabajo y configurar herramientas.

Por ejemplo, la página de herramientas/configuración te permite activar o desactivar integraciones integradas (búsqueda web, Google docs, Slack, etc.), y la pantalla de selección de modelo te permite elegir o configurar tu LLM preferido. Todo a partir de aquí —mensajes de agentes, salidas de herramientas, bases de conocimiento— permanecerá en tu base de datos de PostgreSQL y en el sistema de archivos local, a menos que lo exportes explícitamente.

La interfaz de usuario de Eigent te permite configurar herramientas integradas (Slack, búsqueda web, etc.) en tu instancia local. Elige qué modelos o APIs usar para los agentes en la configuración local de Eigent.

Nota: al ejecutar en modo local, los usuarios deben configurar sus propias claves API o endpoints para los modelos.

Mira el tutorial completo

¿Prefieres una guía visual? Hemos grabado un recorrido paso a paso que te lleva por todo el proceso, desde levantar Docker hasta iniciar sesión en Eigent localmente.

Enlace del tutorial: Ver en YouTube