¿Puedes autoalojar OpenMuse en un VPS? Qué puede ejecutar LightNode

Ilustración conceptual, no una captura de pantalla de la interfaz de OpenMuse o LightNode.

Puede que desees un asistente de IA que navegue por sitios, trabaje con archivos y mantenga una tarea en ejecución mientras tu propio portátil está cerrado. Un VPS puede mantener la aplicación y su worker del navegador en funcionamiento. Pero "autoalojado" puede describir varios tipos de configuraciones, y OpenMuse es un buen ejemplo de por qué los detalles importan.

Este artículo trata sobre CopilotKit/OpenMuse. Otros proyectos comparten el nombre OpenMuse; no se deben mezclar sus instrucciones de despliegue. El proyecto de CopilotKit tiene licencia MIT y actualmente está marcado como Alpha. Es una aplicación de agente personal, no la versión oficial de código abierto de Meta Muse y no es una imagen preinstalada de LightNode.

¿Qué se ejecuta realmente en el VPS?

OpenMuse no requiere ChromeOS ni un escritorio gráfico. Su arquitectura incluye una interfaz web o móvil, una API para conversaciones y tareas en segundo plano, y un worker del navegador separado. El procesamiento de tareas también puede ejecutarse como un worker separado. El worker del navegador utiliza Playwright y Chromium y persiste las sesiones del navegador. La aplicación permite al usuario ver el navegador y tomar el control de una sesión. Un espacio de trabajo Linux opcional se ejecuta en un contenedor Docker para tareas de comandos y archivos; no es una máquina virtual de escritorio remoto completa.

Un VPS Linux de LightNode puede alojar la aplicación, el worker de tareas, el worker del navegador y los datos locales. Esos procesos necesitan que el servidor permanezca en ejecución para que el trabajo en segundo plano continúe. El proyecto almacena su base de datos embebida, archivos y claves de firma en .openmuse/ por defecto, mientras que los perfiles del navegador tienen un almacenamiento persistente separado. Haz copia de seguridad de ambos conjuntos de datos y del volumen del worker del navegador, no solo del repositorio Git clonado. El README del proyecto original describe estas rutas y los roles de los procesos.

El VPS aloja la aplicación OpenMuse y el worker del navegador; los otros servicios requieren su propia configuración.

Un primer despliegue sensato en LightNode

Comienza con una instancia Ubuntu en VPS Linux de LightNode. La guía de inicio rápido del proyecto original requiere Node.js 24 LTS, pnpm 11.19.0 y una clave de proyecto de CopilotKit Intelligence. Ejecuta el ejemplo oficial en un entorno al que solo tú puedas acceder. Confirma que la interfaz web, la API y la sesión se inician antes de añadir un modelo real y el worker del navegador. La demo utiliza datos ficticios; no es una configuración de producción para exponer directamente a clientes.

Los comandos iniciales de la guía del proyecto original son:

git clone https://github.com/CopilotKit/OpenMuse.git openmuse
cd openmuse
pnpm install --frozen-lockfile
cp .env.example .env
npx copilotkit@latest login
npx copilotkit@latest project select

Después de obtener una clave de proyecto, colócala en el archivo .env del servidor como CPK_INTELLIGENCE_API_KEY. Sigue el README para ejecutar pnpm dev y pnpm dev:web para el ejemplo local. Si esos comandos se ejecutan en tu VPS, visualiza el puerto local a través de un túnel SSH; no pongas el servidor de desarrollo directamente en internet público. Un despliegue público también necesita los servicios web y API compilados, tu propio dominio y HTTPS.

Para tareas reales del navegador, configura un proveedor de modelos y el worker del navegador Chromium con su propio secreto. El archivo Docker Compose del proyecto original cubre solo el worker del navegador; no es un despliegue de producción de un solo comando para toda la aplicación. Por defecto, el puerto del worker se vincula a la dirección local del servidor para que la API ubicada en el mismo servidor pueda llamarlo. No expongas el puerto del worker ni su secreto a los visitantes del sitio.

Para un uso a largo plazo, protege los endpoints web y de la API con HTTPS, restringe el acceso administrativo, haz copias de seguridad de la configuración del entorno y los datos del navegador, y prueba si las tareas y sesiones se recuperan después de un reinicio. La guía de seguridad del proyecto recomienda HTTPS y redes restringidas para el despliegue remoto. No existe un mínimo único de VPS del proyecto original que se adapte a cada carga de trabajo del navegador: las pestañas abiertas, las tareas concurrentes y el contenedor Linux opcional afectan al uso de memoria y CPU. Dimensiona el servidor utilizando tus tareas reales.

Lo que cubre y no cubre "autoalojado"

Cada despliegue de OpenMuse necesita CPK_INTELLIGENCE_API_KEY para usar CopilotKit Intelligence para la persistencia y reanudación de conversaciones. Las tareas reales del agente también necesitan un proveedor de modelos o una pasarela de modelos. Ejecutar la aplicación OpenMuse y el navegador en tu propio VPS no significa que la infraestructura de conversación y la inferencia del modelo se ejecuten automáticamente en ese VPS. La documentación de Rich Threads del proyecto describe Intelligence como un servicio configurado por separado, fuera del código con licencia MIT de OpenMuse.

CopilotKit documenta una opción de Intelligence autoalojada, pero requiere el plan autoalojado o empresarial correspondiente. Su ruta soportada implica Kubernetes o AWS ECS y sistemas de soporte como una base de datos y Redis. Para una persona o un equipo pequeño que evalúa OpenMuse en un VPS, la configuración con clave de proyecto oficialmente soportada es el punto de partida más directo. Si tus reglas de adquisición requieren que las conversaciones y la inferencia permanezcan completamente en tu infraestructura, revisa la arquitectura completa, la licencia y el despliegue del modelo antes de hacer esa afirmación.

¿Para quién es esta configuración?

Un desarrollador que quiera cambiar un flujo de trabajo de agente, elegir un modelo y mantener el control de los perfiles del navegador puede comenzar con un VPS. Un equipo pequeño puede usar instancias separadas para proyectos separados, de modo que el código, los datos del navegador y los secretos permanezcan aparte. OpenMuse actualmente soporta un propietario por despliegue. Una clave de acceso compartida no es un sistema de cuentas multiusuario, por lo que una instancia no debe tratarse como una plataforma lista para usar para clientes no relacionados.

Si tu requisito es simplemente abrir Chrome y aplicaciones de escritorio de forma remota, VPS con Escritorio Ubuntu (XFCE) es una opción más adecuada. OpenMuse es para personas dispuestas a operar la aplicación, la conexión del modelo, los secretos y las copias de seguridad mientras un agente realiza tareas. Tampoco proporciona el completo modelo de seguridad de VM dedicada que Meta describe para Muse.

Preguntas frecuentes

¿Es OpenMuse un escritorio en la nube?

No. Permite que un agente use y muestre un navegador Chromium y puede proporcionar un espacio de trabajo opcional en un contenedor Linux. Un escritorio gráfico completo sigue en la hoja de ruta del proyecto. Para una persona que necesita iniciar sesión en un escritorio Ubuntu a través de RDP, usa una configuración de VPS de escritorio en su lugar.

¿Podría LightNode ofrecerlo como una imagen de aplicación de un clic?

Su servicio web, API, workers y almacenamiento persistente podrían empaquetarse en una plantilla de despliegue después de la ingeniería y validación. El archivo Compose actual del proyecto original cubre solo el worker del navegador, y los usuarios aún necesitarían credenciales de CopilotKit Intelligence y configuración del modelo. Hasta que la instalación, el reinicio, la recuperación de copias de seguridad y el uso de recursos hayan sido verificados en un VPS, no debe presentarse como una imagen de LightNode de un clic existente.

¿El precio del VPS incluye modelos de IA y CopilotKit Intelligence?

No. La facturación del VPS cubre el cómputo y almacenamiento que ejecutas en LightNode. El acceso a modelos y CopilotKit Intelligence tienen su propia configuración y precios. Deja margen para los procesos del navegador, las sesiones almacenadas y las copias de seguridad al elegir el tamaño del VPS.

Para probar tu propio flujo de trabajo de agente, crea una instancia Ubuntu en VPS Linux de LightNode, sigue el README de OpenMuse y luego decide si conectar cuentas reales y tareas de larga duración. Para un escritorio operado por una persona, comienza con nuestra guía de escritorio Chrome en la nube.