É possível hospedar o OpenMuse em um VPS? O que a LightNode pode executar

Ilustração conceitual, não uma captura de tela da interface do OpenMuse ou da LightNode.

Você pode querer um assistente de IA para navegar em sites, trabalhar com arquivos e manter uma tarefa em execução enquanto seu próprio laptop está fechado. Um VPS pode manter o aplicativo e seu worker de navegador em execução. Mas "auto-hospedado" pode descrever vários arranjos diferentes, e o OpenMuse é um bom exemplo de por que os detalhes importam.

Este artigo aborda o CopilotKit/OpenMuse. Outros projetos compartilham o nome OpenMuse; suas instruções de implantação não devem ser misturadas. O projeto do CopilotKit é licenciado sob MIT e atualmente marcado como Alpha. É um aplicativo de agente pessoal, não a versão de código aberto oficial do Meta Muse e não uma imagem pré-instalada da LightNode.

O que realmente é executado no VPS?

O OpenMuse não requer ChromeOS ou um desktop gráfico. Sua arquitetura inclui uma interface web ou móvel, uma API para conversas e tarefas em segundo plano, e um worker de navegador separado. O processamento de tarefas também pode ser executado como um worker separado. O worker de navegador usa Playwright e Chromium e persiste sessões do navegador. O aplicativo permite que um usuário visualize o navegador e assuma o controle de uma sessão. Um workspace Linux opcional é executado em um contêiner Docker para tarefas de comando e arquivos; não é uma máquina virtual de desktop remoto completa.

Um VPS Linux da LightNode pode hospedar o aplicativo, o worker de tarefas, o worker de navegador e os dados locais. Esses processos precisam que o servidor permaneça em execução para que o trabalho em segundo plano continue. O projeto armazena seu banco de dados embutido, arquivos e chaves de assinatura em .openmuse/ por padrão, enquanto os perfis do navegador têm armazenamento persistente separado. Faça backup de ambos os conjuntos de dados e do volume do worker de navegador, não apenas do checkout do Git. O README upstream descreve esses caminhos e funções dos processos.

O VPS hospeda o aplicativo OpenMuse e o worker de navegador; os outros serviços requerem sua própria configuração.

Uma primeira implantação sensata na LightNode

Comece com uma instância Ubuntu em um VPS Linux LightNode. O início rápido upstream exige Node.js 24 LTS, pnpm 11.19.0 e uma chave de projeto do CopilotKit Intelligence. Execute o exemplo oficial em um ambiente ao qual apenas você tenha acesso. Confirme que a interface web, a API e a sessão iniciam antes de adicionar um modelo real e um worker de navegador. A demonstração usa dados fictícios; não é uma configuração de produção para expor diretamente a clientes.

Os comandos iniciais no guia upstream são:

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

Após obter uma chave de projeto, coloque-a no .env do lado do servidor como CPK_INTELLIGENCE_API_KEY. Siga o README para executar pnpm dev e pnpm dev:web para o exemplo local. Se esses comandos forem executados em seu VPS, visualize a porta local através de um túnel SSH; não coloque o servidor de desenvolvimento diretamente na internet pública. Uma implantação pública também precisa dos serviços web e API construídos, seu próprio domínio e HTTPS.

Para tarefas reais de navegador, configure um provedor de modelo e o worker de navegador Chromium com seu próprio segredo. O arquivo Docker Compose upstream cobre apenas o worker de navegador; não é uma implantação de produção de um comando único para todo o aplicativo. Por padrão, a porta do worker é vinculada ao endereço local do servidor para que a API co-localizada possa chamá-la. Não exponha a porta do worker ou seu segredo aos visitantes do site.

Para uso de longo prazo, proteja os endpoints web e da API com HTTPS, restrinja o acesso administrativo, faça backup das configurações de ambiente e dos dados do navegador, e teste se as tarefas e sessões se recuperam após uma reinicialização. A orientação de segurança do projeto recomenda HTTPS e redes restritas para implantação remota. Não há um mínimo único de VPS upstream que se adapte a toda carga de trabalho do navegador: abas abertas, tarefas simultâneas e o contêiner Linux opcional afetam o uso de memória e CPU. Dimensione o servidor usando suas tarefas reais.

O que "auto-hospedado" cobre e não cobre

Toda implantação do OpenMuse precisa de CPK_INTELLIGENCE_API_KEY para usar o CopilotKit Intelligence para persistência e retomada de conversas. Tarefas reais de agente também precisam de um provedor de modelo ou gateway de modelo. Executar o aplicativo e o navegador do OpenMuse em seu próprio VPS não significa que a infraestrutura de conversa e a inferência do modelo sejam executadas automaticamente nesse VPS. A documentação Rich Threads do projeto descreve o Intelligence como um serviço configurado separadamente fora do código licenciado em MIT do OpenMuse.

O CopilotKit documenta uma opção de Intelligence auto-hospedada, mas ela requer o plano auto-hospedado ou empresarial apropriado. Seu caminho suportado envolve Kubernetes ou AWS ECS e sistemas de suporte, como um banco de dados e Redis. Para uma pessoa ou uma pequena equipe avaliando o OpenMuse em um VPS, a configuração com chave de projeto oficialmente suportada é o ponto de partida mais direto. Se suas regras de aquisição exigirem que conversas e inferência permaneçam totalmente em sua infraestrutura, verifique a arquitetura completa, a licença e a implantação do modelo antes de fazer essa afirmação.

Para quem é essa configuração?

Um desenvolvedor que deseja alterar um fluxo de trabalho de agente, escolher um modelo e manter o controle dos perfis do navegador pode começar com um VPS. Uma pequena equipe pode usar instâncias separadas para projetos separados, para que código, dados do navegador e segredos permaneçam separados. O OpenMuse atualmente suporta um proprietário por implantação. Uma chave de acesso compartilhada não é um sistema de conta multi-usuário, portanto, uma instância não deve ser tratada como uma plataforma pronta para clientes não relacionados.

Se seu requisito é simplesmente abrir o Chrome e aplicativos de desktop remotamente, um VPS Ubuntu Desktop (XFCE) é mais adequado. O OpenMuse é para pessoas dispostas a operar o aplicativo, a conexão do modelo, os segredos e os backups enquanto um agente executa tarefas. Ele também não fornece o modelo completo de segurança de VM dedicada que a Meta descreve para o Muse.

Perguntas frequentes

O OpenMuse é um desktop na nuvem?

Não. Ele permite que um agente use e exiba um navegador Chromium e pode fornecer um workspace Linux opcional em contêiner. Um desktop gráfico completo permanece no roteiro do projeto. Para uma pessoa que precisa fazer login em um desktop Ubuntu via RDP, use uma configuração de VPS com desktop.

A LightNode poderia oferecê-lo como uma imagem de aplicativo com um clique?

Seu serviço web, API, workers e armazenamento persistente poderiam ser empacotados em um modelo de implantação após engenharia e validação. O arquivo Compose upstream atual cobre apenas o worker de navegador, e os usuários ainda precisariam de credenciais do CopilotKit Intelligence e configuração do modelo. Até que a instalação, reinicialização, recuperação de backup e uso de recursos tenham sido verificados em um VPS, ele não deve ser apresentado como uma imagem LightNode de um clique existente.

O preço do VPS inclui modelos de IA e CopilotKit Intelligence?

Não. A cobrança do VPS cobre a computação e o armazenamento que você executa na LightNode. O acesso ao modelo e ao CopilotKit Intelligence têm sua própria configuração e preços. Reserve espaço para processos do navegador, sessões armazenadas e backups ao escolher o tamanho do VPS.

Para testar seu próprio fluxo de trabalho de agente, crie uma instância Ubuntu em um VPS Linux LightNode, percorra o README do OpenMuse e então decida se deseja conectar contas reais e tarefas de longa duração. Para um desktop operado por uma pessoa, comece com nosso guia de desktop Chrome na nuvem.