OpenMuse auf einem VPS selbst hosten – Was LightNode ausführen kann

LightNode
By LightNode ·

Illustration eines selbst gehosteten Browser-Agenten, der auf einem Cloud-Server läuft

Konzeptillustration, kein Screenshot der OpenMuse- oder LightNode-Oberfläche.

Sie möchten vielleicht einen KI-Assistenten, der Websites durchsucht, mit Dateien arbeitet und Aufgaben fortsetzt, während Ihr eigener Laptop geschlossen ist. Ein VPS kann die Anwendung und ihren Browser-Worker am Laufen halten. Aber "selbst gehostet" kann verschiedene Konfigurationen beschreiben, und OpenMuse ist ein gutes Beispiel dafür, warum die Details wichtig sind.

Dieser Artikel behandelt CopilotKit/OpenMuse. Andere Projekte teilen sich den Namen OpenMuse; deren Bereitstellungsanweisungen sollten nicht vermischt werden. Das Projekt von CopilotKit ist unter der MIT-Lizenz veröffentlicht und derzeit als Alpha markiert. Es handelt sich um eine persönliche Agenten-Anwendung, nicht um die offizielle Open-Source-Freigabe von Meta Muse und kein vorinstalliertes LightNode-Image.

Was läuft tatsächlich auf dem VPS?

OpenMuse benötigt weder ChromeOS noch eine grafische Desktop-Oberfläche. Seine Architektur umfasst eine Web- oder Mobile-Oberfläche, eine API für Konversationen und Hintergrundaufgaben sowie einen separaten Browser-Worker. Die Aufgabenverarbeitung kann ebenfalls als separater Worker ausgeführt werden. Der Browser-Worker nutzt Playwright und Chromium und speichert Browsersitzungen persistent. Die Anwendung ermöglicht es einem Nutzer, den Browser zu sehen und eine Sitzung zu übernehmen. Ein optionaler Linux-Arbeitsbereich läuft in einem Docker-Container für Befehls- und Dateiaufgaben; es handelt sich nicht um eine vollständige Remote-Desktop-Virtual-Machine.

Ein LightNode Linux VPS kann die Anwendung, den Task-Worker, den Browser-Worker und lokale Daten hosten. Diese Prozesse benötigen einen laufenden Server, damit Hintergrundarbeiten fortgesetzt werden können. Das Projekt speichert seine eingebettete Datenbank, Dateien und Signaturschlüssel standardmäßig unter .openmuse/, während Browser-Profile einen separaten persistenten Speicher haben. Sichern Sie beide Datensätze und das Volume des Browser-Workers, nicht nur den Git-Checkout. Das upstream README beschreibt diese Pfade und Prozessrollen.

Diagramm, das OpenMuse-Dienste und Chromium auf dem VPS zeigt, mit separat konfigurierter CopilotKit Intelligence und einem Model-Provider

Der VPS hostet die OpenMuse-Anwendung und den Browser-Worker; die anderen Dienste erfordern eine eigene Konfiguration.

Eine sinnvolle erste Bereitstellung auf LightNode

Beginnen Sie mit einer Ubuntu-Instanz auf LightNode Linux VPS. Der Quick Start von upstream erfordert Node.js 24 LTS, pnpm 11.19.0 und einen CopilotKit Intelligence-Projektschlüssel. Führen Sie das offizielle Beispiel in einer Umgebung aus, auf die nur Sie Zugriff haben. Vergewissern Sie sich, dass die Weboberfläche, API und Sitzung starten, bevor Sie ein echtes Modell und einen Browser-Worker hinzufügen. Die Demo verwendet fiktive Daten; es handelt sich nicht um ein Produktions-Setup, das direkt Kunden zugänglich gemacht werden sollte.

Die ersten Befehle im upstream-Leitfaden sind:

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

Nachdem Sie einen Projektschlüssel erhalten haben, tragen Sie ihn serverseitig in .env als CPK_INTELLIGENCE_API_KEY ein. Befolgen Sie das README, um pnpm dev und pnpm dev:web für das lokale Beispiel auszuführen. Wenn diese Befehle auf Ihrem VPS laufen, rufen Sie den lokalen Port über einen SSH-Tunnel auf; stellen Sie den Entwicklungsserver nicht direkt ins öffentliche Internet. Eine öffentliche Bereitstellung benötigt außerdem gebaute Web- und API-Dienste, eine eigene Domain und HTTPS.

Für echte Browser-Aufgaben konfigurieren Sie einen Model-Provider und den Chromium-Browser-Worker mit seinem eigenen Secret. Die upstream Docker Compose-Datei deckt nur den Browser-Worker ab; es handelt sich nicht um eine Ein-Befehl-Produktionsbereitstellung der gesamten Anwendung. Standardmäßig bindet sich der Worker-Port an die lokale Adresse des Servers, damit die API, die auf demselben System läuft, ihn aufrufen kann. Machen Sie den Worker-Port oder sein Secret nicht für Seitenbesucher zugänglich.

Für eine langfristige Nutzung schützen Sie die Web- und API-Endpunkte mit HTTPS, beschränken den administrativen Zugriff, sichern Sie Umgebungsvariablen und Browserdaten und testen Sie, ob Aufgaben und Sitzungen nach einem Neustart wiederhergestellt werden. Die Sicherheitsrichtlinien des Projekts empfehlen HTTPS und eingeschränkte Netzwerke für die Remote-Bereitstellung. Es gibt keine einzige upstream VPS-Mindestanforderung, die für jede Browser-Arbeitslast passt: geöffnete Tabs, gleichzeitige Aufgaben und der optionale Linux-Container beeinflussen alle den Speicher- und CPU-Verbrauch. Dimensionieren Sie den Server anhand Ihrer tatsächlichen Aufgaben.

Was "selbst gehostet" abdeckt und was nicht

Jede OpenMuse-Bereitstellung benötigt CPK_INTELLIGENCE_API_KEY, um CopilotKit Intelligence für die Persistenz und Wiederaufnahme von Konversationen zu nutzen. Echte Agenten-Aufgaben benötigen außerdem einen Model-Provider oder Model-Gateway. Das Ausführen der OpenMuse-Anwendung und des Browsers auf Ihrem eigenen VPS bedeutet nicht, dass die Konversationsinfrastruktur und Modell-Inferenz automatisch auf diesem VPS laufen. Die Rich Threads-Dokumentation des Projekts beschreibt Intelligence als einen separat konfigurierten Dienst außerhalb des MIT-lizenzierten Codes von OpenMuse.

CopilotKit dokumentiert eine selbst gehostete Intelligence-Option, diese erfordert jedoch den entsprechenden Self-Hosted- oder Enterprise-Plan. Der unterstützte Weg beinhaltet Kubernetes oder AWS ECS sowie unterstützende Systeme wie eine Datenbank und Redis. Für eine Einzelperson oder ein kleines Team, das OpenMuse auf einem VPS evaluiert, ist die offiziell unterstützte Projekt-Schlüssel-Einrichtung der direktere Startpunkt. Wenn Ihre Beschaffungsrichtlinien erfordern, dass Konversationen und Inferenz vollständig auf Ihrer Infrastruktur bleiben, prüfen Sie die vollständige Architektur, Lizenz und Modellbereitstellung, bevor Sie diese Behauptung aufstellen.

Für wen ist dieses Setup geeignet?

Ein Entwickler, der einen Agenten-Workflow ändern, ein Modell wählen und die Kontrolle über Browser-Profile behalten möchte, kann mit einem VPS beginnen. Ein kleines Team kann separate Instanzen für separate Projekte verwenden, sodass Code, Browserdaten und Secrets getrennt bleiben. OpenMuse unterstützt derzeit einen Eigentümer pro Bereitstellung. Ein gemeinsamer Zugangsschlüssel ist kein Multi-User-Kontosystem, daher sollte eine Instanz nicht als fertige Plattform für nicht zusammenhängende Kunden behandelt werden.

Wenn Ihre Anforderung einfach darin besteht, Chrome und Desktop-Anwendungen remote zu öffnen, ist Ubuntu Desktop (XFCE) VPS besser geeignet. OpenMuse ist für Personen gedacht, die bereit sind, die Anwendung, Modellverbindung, Secrets und Backups zu betreiben, während ein Agent Aufgaben ausführt. Es bietet auch nicht das vollständige dedicated-VM-Sicherheitsmodell, das Meta für Muse beschreibt.

Häufig gestellte Fragen

Ist OpenMuse ein Cloud-Desktop?

Nein. Es ermöglicht einem Agenten, einen Chromium-Browser zu nutzen und anzuzeigen, und kann einen optionalen Linux-Container-Arbeitsbereich bereitstellen. Ein vollständiger grafischer Desktop steht noch auf der Roadmap des Projekts. Für eine Person, die sich über RDP bei einem Ubuntu-Desktop anmelden muss, verwenden Sie stattdessen ein Desktop-VPS-Setup.

Könnte LightNode es als One-Click-Anwendungs-Image anbieten?

Sein Webdienst, API, Worker und persistenter Speicher könnten nach Engineering und Validierung in eine Bereitstellungsvorlage verpackt werden. Die aktuelle upstream Compose-Datei deckt nur den Browser-Worker ab, und Benutzer würden immer noch CopilotKit Intelligence-Zugangsdaten und Modellkonfiguration benötigen. Bis Installation, Neustart, Backup-Wiederherstellung und Ressourcennutzung auf einem VPS verifiziert wurden, sollte es nicht als existierendes One-Click-LightNode-Image präsentiert werden.

Beinhaltet der VPS-Preis KI-Modelle und CopilotKit Intelligence?

Nein. Die VPS-Abrechnung deckt die Rechen- und Speicherressourcen ab, die Sie auf LightNode nutzen. Der Modellzugang und CopilotKit Intelligence haben ihre eigene Konfiguration und Preisgestaltung. Berücksichtigen Sie bei der Wahl der VPS-Größe Platz für Browser-Prozesse, gespeicherte Sitzungen und Backups.

Um Ihren eigenen Agenten-Workflow zu testen, erstellen Sie eine Ubuntu-Instanz auf LightNode Linux VPS, arbeiten Sie das OpenMuse README durch und entscheiden Sie dann, ob Sie echte Konten und langlaufende Aufgaben verbinden möchten. Für einen personenbetriebenen Desktop beginnen Sie mit unserem Cloud Chrome Desktop-Leitfaden.