Installation und Aktualisierungen
Die meisten Benutzer sollten das Desktop-Paket von GitHub Releases installieren. Mitwirkende oder alle, die den neuesten code testen, können die app von der quelle aus ausführen. Der Electron-Desktop-Client verbindet sich mit einem gemeinsamen Node-Backend, das auch die authentifizierte lokale Browseroberfläche bedient.
Aktuelle Pakete: v1.0.5 Assets Dazu gehören Desktop-Installer, eigenständige CLI-Archive und Linux-CLI .deb/.rpm Packungen. Wählen Sie den vorgesehenen Installationstyp und die Architektur aus und überprüfen Sie dann die Prüfsumme aus demselben Release. Der Desktop Launcher bleibt verfügbar durch Settings → General → Command line tool → Install command.
Wählen Sie eine Installationsmethode
Download eines Desktop-Installationsprogramms
- Öffnen Sie Open-Science Releases.
- Laden Sie das Paket herunter, das zu Ihrem Betriebssystem und Ihrer CPU-Architektur passt.
- Lesen Sie die vom Installateur angezeigte Lizenz und schließen Sie die Installation ab, starten Sie dann die App. Ein fünfstufiger Setup-Assistent öffnet sich beim ersten Durchlauf.
- Wenn das Betriebssystem eine nicht signierte App blockiert, laden Sie sie erneut aus dem offiziellen AIPOCH GitHub-Repository herunter und folgen Sie der Sicherheitsaufforderung der Plattform erst nach Überprüfung der Quelle.
Wählen Sie aus dem Vermögenswerte, das an das Release angehängt ist, und nicht aus dem automatisch generierten Quellcode ZIP. Die Verfügbarkeit hängt von den veröffentlichten Assets dieser Veröffentlichung ab.
| Computer | Identifizieren Sie die Architektur | Paket und Installation |
|---|---|---|
| macOS, Apple Silicon | Über diesen Mac zeigt einen Apple M-Serie Chip | Wählen Sie mac-arm64.dmg; Öffnen Sie es, ziehen Sie die App zu Anwendungen, dann starten Sie es dort |
| macOS, Intel | Über diesen Mac zeigt einen Intel-Prozessor | Wählen Sie mac-x64.dmg; Installieren in Anwendungen. Die App benötigt macOS 12 oder höher |
Installieren Sie mit Homebrew
Sie können auch mit Homebrew installieren:
brew install --cask open-science
Homebrew wählt Apple Silicon oder Intel automatisch aus. Öffnen Sie nach der Installation Settings → General → About und bestätigen Sie die installierte Version; Ein Paketmanager kann ein neueres Release als die Dokumentations-Baseline auflösen. Tags Installationsanweisungen.
Offizielle Windows-Installateure sind von v0.33.2 signiert; v0.33.3 erweitert die Signatur auf gebündelte ausführbare Dateien. Laden Sie von Offizielle Download-Seite oder GitHub Releases herunter und folgen Sie den offiziellen Verifizierungshinweisen, um die Paketquelle zu überprüfen.
| Computer | Identifizieren Sie die Architektur | Paket und Installation |
|---|---|---|
| Windows | Einstellungen → System → Über → Systemtyp | Wählen Sie das Matching win-…-setup.exe; Führen Sie den aktuellen Benutzer-Installer aus und folgen Sie seinen Standortaufforderungen |
- Öffnen Sie das heruntergeladene Windows-Installationsprogramm und gehen Sie zur Seite Installationsort.
- Behalten Sie den Standardspeicherort bei oder wählen Sie Browse…, um einen Ordner für die Anwendung auszuwählen, und wählen Sie dann Install.
- Warten Sie auf die Abschlussseite. Lassen Sie die Startoption ausgewählt und wählen Sie Finish, um Open-Science zu öffnen.
- Folgen Sie Ersteinrichtung, um die Umgebung zu überprüfen und den Datenstandort, den Agenten und das Modell zu konfigurieren.
| Computer | Identifizieren Sie die Architektur | Paket und Installation |
|---|---|---|
| Ubuntu / Debian | uname -m: x86_64 bedeutet x64, aarch64 bedeutet ARM64 | Wählen Sie das Matching .deb, öffnen Sie es mit dem Systempaket-Installer und starten Sie dann aus dem Anwendungsmenü |
| Andere unterstützte Linux-Distributionen | Überprüfung uname -m | Wählen Sie das Matching .AppImageErlauben Sie die Ausführung in den Berechtigungen der Datei und öffnen Sie sie dann; Beheben Sie alle Abhängigkeitsfehler, die von der Verteilung gemeldet wurden |
v1.0.5 bietet Linux x64 und ARM64 Packungen. Für ARM64 auswählen aipoch-open-science-1.0.5-linux-arm64.AppImage oder aipoch-open-science_1.0.5_arm64.deb. Die x64 Gegenstücke sind aipoch-open-science-1.0.5-linux-x86_64.AppImage und aipoch-open-science_1.0.5_amd64.deb. Download von den offiziellen Assets des ausgewählten Releases und Übereinstimmung mit dem Ergebnis uname -m.
Der Installationsordner enthält die Anwendung; Data location im Einrichtungsassistenten enthält Forschungsdateien und Laufzeitumgebungen. Beide Speicherorte werden getrennt festgelegt. Fahren Sie nach der Installation mit der Ersteinrichtung fort.
Verwenden Sie das Standalone CLI
Für eine Terminal-/Browser-Installation laden Sie ein passendes Standalone-CLI-Archiv von v1.0.5. Es bündelt Node, das Backend und die Web-Benutzeroberfläche. Extrahieren Sie das komplette Verzeichnis, dann folgen CLI-Einrichtung. Halten Sie die CLI und das Backend aus derselben Installation zusammen.
HomeBrew CLI
Installieren oder Verwalten der Homebrew CLI mit brew install aipoch/tap/open-science, getrennt vom Desktop-Fass. Überprüfen Sie die von Homebrew tatsächlich angebotene Version; Die Formel kann hinter einer GitHub-Version zurückbleiben. Die Installation startet keinen Systemdienst. Wenn Trägerraketen Konflikt, inspizieren type -a open-science und Verwendung "$(brew --prefix aipoch/tap/open-science)/bin/open-science" für diese Anlage.
Linux CLI Pakete
Für Linux-Terminal / Browser verwenden, wählen Sie open-science-cli, getrennt von der aipoch-open-science Desktop-Paket. Laden Sie das passende Paket herunter und CLI-PACKAGE-SHA256SUMS.txt von v1.0.5 AssetsÜberprüfen Sie dann vor der Installation.
| Distribution / Architektur | v1.0.5 CLI-Asset |
|---|---|
| Debian / Ubuntu, x64 | open-science-cli_1.0.5_amd64.deb |
| Debian / Ubuntu, ARM64 | open-science-cli_1.0.5_arm64.deb |
| Fedora, x64 | open-science-cli-1.0.5-1.x86_64.rpm |
| Fedora, ARM64 | open-science-cli-1.0.5-1.aarch64.rpm |
Installieren Sie die heruntergeladene Datei mit dem entsprechenden Paketmanager. Diese Beispiele verwenden x64; Verwenden Sie gegebenenfalls den ARM64-Dateinamen.
# Debian / Ubuntu
sudo apt install ./open-science-cli_1.0.5_amd64.deb
# Fedora: use this instead of the apt command
sudo dnf install ./open-science-cli-1.0.5-1.x86_64.rpm
Führen Sie open-science-cli start --no-open, dann open-science-cli status --json. Verwenden Sie nach der Ausführung open-science-cli url, um die authentifizierte lokale Weboberfläche zu öffnen; Halten Sie diese URL privat. Fahren Sie mit CLI Setup für die Modellkonfiguration und doctor-Prüfungen fort und ersetzen Sie open-science durch open-science-cli in diesen Befehlen.
Das Paket bündelt Node, das Backend und die Web-Benutzeroberfläche. Es installiert weder Python/R noch erstellt es einen automatisch gestarteten Systemdienst. Die OS-Anmeldedatenspeicher- und Sandbox-Voraussetzungen gelten weiterhin; siehe Headless Linux-Zugangsdaten. Verwenden Sie open-science-cli explizit, wenn auch ein Desktop-Launcher installiert ist.
Bevor Sie das Paket aktualisieren oder entfernen, beenden Sie die Arbeit und stoppen Sie jedes Profil, das von diesem Paket gestartet wurde. Installieren Sie das nächste heruntergeladene Paket über apt/dnf; es gibt kein AIPOCH apt/dnf-Repository, das von dieser Installation konfiguriert wird. Paketentfernung bewahrt Forschungsdaten und Anmeldeinformationen. Die Offizieller Paketführer beschreibt Befehlskonflikte und Plattformanforderungen.
Laufen aus der Quelle
Sie benötigen Git, Node.js 24, npm und die Plattformbauvoraussetzungen für Electron. Installieren oder wählen Sie ein Agent-Framework in der Anwendung aus. Während der Installation generiert das Repository den Prisma Client, wendet App-Patches an und bereitet native Electron-Abhängigkeiten vor.
Für eine reproduzierbare Quellinstallation wählen Sie den beabsichtigten Release-Tag aus Changelog bevor Abhängigkeiten installiert werden. Ein Standardklon folgt dem Branch und nicht einem festen Release. Notieren Sie die ausgewählten Tag-, Source-Commit- und Runtime-Versionen, damit eine andere Person die Umgebung reproduzieren kann.
Ersetzen Sie RELEASE_TAG unten durch das genaue Tag, das auf dem ausgewählten Release angezeigt wird (einschließlich des führenden v). Um der laufenden Entwicklung zu folgen, lassen Sie stattdessen --branch RELEASE_TAG --depth 1 weg; Dieser Checkout folgt dem Default Branch.
git clone --branch RELEASE_TAG --depth 1 https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev
Vor dem Verpacken eines Produktions-Builds führen Sie Folgendes aus:
npm run build
Verwenden Sie das ausgewählte tag package.json und Standalone Runtime Guide für seine Build-Ziele und Abhängigkeiten. npm run dev:web entwickelt den Node/Web-Eingangspunkt; npm run dev Bereitet auch den Desktop-Client vor. Verwenden Sie ein isoliertes Konfigurationsverzeichnis, um Testdaten getrennt zu halten.
Vollständige Ersteinrichtung
Externe Dienste und Laufzeiten
| Leistungsfähigkeit | Erforderlich? | Zweck |
|---|---|---|
| OpenCode, Claude Agent, Codex oder CodeBuddy | Mindestens eine | Führt Gesprächsagentensitzungen durch |
| Zugang zu Modellen | Erforderlich für Agentenanfragen | Ein unterstütztes Abonnement oder API-Anbieter; Der Abonnementzugriff erfordert keinen separaten API-Schlüssel |
| Python oder R | Fakultativ | Läuft Notebook-Code aus; Verwenden einer erkannten Systemumgebung oder einer App-verwalteten Umgebung |
| Netzwerkzugriff | Empfohlen | Installiert Laufzeiten und verbindet Anbieter, GitHub, Remotedienste und MCP Connectors |
| SSH-Host | Fakultativ | Führt Remote-Jobs aus und ruft Ergebnisse über das Compute-Panel ab |
Lokale Daten
Der Setup-Assistent zeigt den verwalteten Datenspeicherort für große Forschungsdateien wie Artefakte, Notebook-Dateien und Umgebungen an. Anwendungseinstellungen und Konversationshistorie bleiben am Konfigurationsort. Das Verschieben des Forschungsdatenstandorts ist kein vollständiges Anwendungs-Backup. Halten Sie es vom Quell-Repository getrennt; Verwenden Sie Speicher, um es zu verschieben, anstatt interne Dateien manuell zu verschieben, während die App ausgeführt wird.
Bestätigen Sie, dass die App bereit ist
Die Anwendung wird geöffnet, die erforderlichen Umgebungsprüfungen werden bestanden, ein Agent wird installiert und der Modellzugriff wird überprüft. Python/R-Setup ist zusätzlich nur für Arbeiten erforderlich, die diese Sprachen ausführen. Das Öffnen einer CSV- oder PDF-Vorschau validiert keine Notebook-Laufzeit. Folgen Sie Ersteinrichtung, dann Anbieter und lokales Modell-Setup.
Überprüfen Sie nach Anwendungsupdates
Lesen Sie in Settings → General → About die installierte Version und verwenden Sie Check now, um die Verfügbarkeit der Updates zu überprüfen. Überprüfen Sie die aufgeführte Version, bevor Sie sie installieren, und beenden Sie zuerst die aktive Arbeit. Ein Build einer Entwicklungsquelle kann Updates unterschiedlich von einer verpackten Installation melden. Bewahren Sie eine Kopie wichtiger exportierter Ergebnisse vor einem Update auf; Benennen Sie die internen Datenverzeichnisse der Anwendung nicht um.
Aus 1.0 wird open-science update entfernt. Aktualisieren Sie die App über ihre Desktop-Steuerelemente oder das offizielle Installationsprogramm und aktualisieren Sie eine CLI-Installation über den Installer / Paketmanager, der sie besitzt. Wenn Check now noch kein veröffentlichtes Release anbietet, überprüfen Sie die offizielle Release-Seite; Das Löschen der Konfiguration oder das Zurücksetzen der App fördert keinen Update-Kanal.
Wenn Installieren Sie Open-Science vor dem Aktualisieren angezeigt wird, läuft die App von einem schreibgeschützten Speicherort aus. Wählen Sie In „Programme“ installieren oder verschieben Sie die App dort im Finder. Verwenden Sie nach der Installation Neustart oder beenden Sie diese Kopie und öffnen Sie die Kopie in Anwendungen erneut und suchen Sie dann erneut nach Updates. Weiter verwenden hält die aktuelle Kopie offen; Es macht diesen standort nicht aktualisierbar. Wenn die Installation fehlschlägt, folgen Sie dem angezeigten Fehler, bevor Sie erneut versuchen.
Die Neuinstallation behält vorhandene Daten bei. Wenn Sie nach einem Datenproblem bewusst einen Neuanfang benötigen, siehe Lokale Windows-Daten zurücksetzen. Dieses separate Tool löscht Daten; Es ist nicht Teil eines gewöhnlichen Updates.
Fehlerbehebung Installation und Start
| Wo es scheitert | Erste Kontrollen |
|---|---|
| Desktop-Installationsprogramm oder App-Start | Überprüfen Sie die Paketquelle, die Betriebssystem- und CPU-Architektur und lesen Sie dann die Eingabeaufforderung des Betriebssystems. |
| Quelleninstallation | Bestätigung node --version und npm --version, und das npm install abgeschlossen. Wiederholen Sie eine unterbrochene Abhängigkeitsinstallation. |
| Ersteinrichtung | Lesen Sie den fehlgeschlagenen Umwelt-Check und lösen Sie die angegebene Anforderung, bevor Sie fortfahren. |
| Erster Agent Request | Bestätigen Sie einen Active/Ready Agent und führen Sie Test connection auf der Modellseite. |
| Provider oder lokale Browserverbindung | Überprüfen Sie den gemeldeten Port-, Proxy- oder Zertifikatsfehler; siehe Fehlerbehebung. |
Produktname nach v0.31.0
Die aktuelle Schnittstelle und neue Pakete verwenden Open-Science konsequent. Das Upgrade bewahrt vorhandene Installationsnamen und -standorte, Forschungsdaten, Anmeldeinformationen und Einstellungen. Ein älterer Installationspfad, der Open Science enthält, ist an sich kein Upgrade-Fehler. Namen Sie die Datenordner nicht um oder verschieben Sie sie nicht so, dass sie dem neuen Anzeigenamen entsprechen.
Upgrade auf 1.0 und Kompatibilität verstehen
- Beenden Sie die aktive Recherche und sichern Sie das Konfigurationsverzeichnis sowie einen separat konfigurierten Datenspeicherort. Ein
.scienceExport ist kein Backup des gesamten Profils. - Schließen Sie Desktop-/Backend-Instanzen mit der Installation und aktualisieren Sie dann über das offizielle Installationsprogramm. Bewahren Sie das ursprüngliche Profil, die Daten und den OS-Anmeldedatenspeicher auf.
- Öffnen und überprüfen Sie die Version, Projekte, Sitzungen, Dateien, Modell und Laufzeiten, bevor Sie fortfahren. Ein binäres Downgrade führt nicht zum Zurücksetzen von Daten; Ältere Binärdateien lesen möglicherweise keine neueren gespeicherten Daten.
1.0 behält bestehende historische Upgrade- und Importpfade bei; die Versionsnummer erfordert kein Zurücksetzen des Profils. Die 1.x Kompatibilitätsrichtlinie umfasst dokumentierte CLI/SDK- und Task-Automatisierungsschnittstellen, Vorwärtsimporte von gültigen .science Pakete und unterstützte Profil-Upgrades. Es garantiert keine identischen Modellantworten, Verfügbarkeit von Drittanbietern oder deterministische Reproduktion einer ganzen Forschungssitzung oder plattformübergreifende Übertragung von OS-geschützten Anmeldeinformationen. Sicherheitskorrekturen zielen auf die neueste stabile Version ab.
Installieren Sie die CLI mit npm
Verwenden Sie Node.js 22.13 oder später für das veröffentlichte CLI/Backend-Paket. Installieren und prüfen Sie in einem Terminal die aufgerufene Version:
npm install --global @aipoch/[email protected]
open-science version --json
open-science help
Dann folgt Terminaleinrichtung um ein Profil zu initialisieren, sein Backend zu starten und ein Modell zu konfigurieren. Die Installation allein meldet Sie nicht an oder installiert Python/R. Wenn ein Desktop- oder Homebrew-Launcher bereits den gleichen Befehlsnamen verwendet, prüfen Sie, welche ausführbare Datei Ihre Shell auswählt, bevor Sie fortfahren. Stoppen Sie jedes Backend, das einer Installation gehört, bevor Sie diese Installation aktualisieren; behalten Sie ihr Profil bei und aktualisieren Sie es über den ursprünglichen Paketmanager.
Folgen Sie einem Update bis zur Installation
In Settings → General → About, wählen Check now Überprüfen Sie die angebotene Freigabe. Der Update-Dialog hält Download-Fortschritt, Release Notes und Installationsvorbereitung zusammen. Download-Abschluss ist kein Installationsabschluss: Überprüfen Sie die installierte Version nach dem Relaunch.
Wenn die App sagt, dass die automatische Installation für diesen Kanal nicht verfügbar ist, behalten Sie das heruntergeladene Paket und verwenden Sie das offizielle Installationsprogramm nach Abschluss der aktiven Arbeit. Die Installationskanäle v1.0.5 schränken den automatischen Austausch weiterhin ein; ein verbesserter Windows-Fortschrittsdialog hebt diese Einschränkung nicht auf. Erzwingen Sie nicht, dass die App geschlossen wird, während das Notebook bereinigt wird.
Installieren Sie ein Update manuell
Im Update-Dialog öffnen Installation instructions. Verwendung Download from website Wenn Sie kein Paket haben. Für einen bestätigten heruntergeladenen Installer wählen Sie Show in Finder, Show in File Explorer oder Show in file managerabhängig von der Plattform. Halten Sie diesen Ordner offen, während Sie die App beenden.
Speichern Sie Arbeit und warten Sie, bis die aktive Installation oder Bereinigung abgeschlossen ist, bevor Sie ein anderes Installationsprogramm starten. Öffnen Sie auf macOS das DMG oder öffnen Sie das Paket und ersetzen Sie Open-Science in Applications. Führen Sie unter Windows das Installationsprogramm mit dem vorhandenen Installationsordner aus. Installieren Sie unter Linux die passende DEB oder ersetzen Sie das AppImage und behalten Sie die ausführbare Berechtigung bei. Folgen Sie den Anweisungen für Ihr tatsächliches Paketformat.
Wenn das Installationsprogramm fehlt oder sich geändert hat, laden Sie es erneut herunter; das Offenlegen eines Pakets führt es nicht aus. Open Open-Science und Check Settings → General → Aboutbestätigen Sie dann Ihre ursprünglichen Projekte und Daten. Beim Aktualisieren von Standalone-CLI-Dateien, zuerst Überprüfen Sie, ob alle betroffenen Dienste gestoppt wurden.