Установка и обновления

Большинство пользователей должны установить пакет рабочего стола из GitHub Releases. Участники или любой, кто тестирует новейший код, могут запустить приложение из источника. Open-Science - это электронное приложение. Его рендерер также поддерживает защищенный токеном локальный доступ к браузеру.

Платформа

macOSWindowsLinux

Ваш выбор хранится в разных главах.

Выберите метод установки

Скачать десктопный установщик

1. Открыть Open-Science выпустили.
2. Загрузите пакет, который соответствует вашей операционной системе и архитектуре процессора.
3. Прочитайте лицензию, показанную установщиком, и заполните установку, затем запустите приложение. Пятиступенчатый мастер настройки открывается на первом пробеге.
4. Если операционная система блокирует неподписанное приложение, скачайте его снова из официального репозитория AIPOCH GitHub и следуйте запросу безопасности платформы только после проверки источника.

Выберите из Активы, прикрепленного к выпуску, а не автоматически сгенерированный исходный код ZIP. Доступность зависит от опубликованных активов этого выпуска.

компьютер	Определите архитектуру	Упаковка и установка
macOS, Apple Silicon	Об этом Mac показывает чип Apple M-серии	Выбрать mac-arm64.dmg; Откройте его, перетащите приложение в Приложения, а затем запустите его там.
macOS, Intel	Об этом Mac показывает процессор Intel	Выбрать mac-x64.dmg; Установка в приложениях. Приложение требует macOS 12 или более позднюю версию.

Установка с Homebrew

Вы также можете установить Homebrew:

brew install --cask open-science

Homebrew автоматически выбирает Apple Silicon или Intel. После установки откройте Settings → General → About и подтвердите установленную версию; Менеджер пакетов может разрешить более новый выпуск, чем базовый уровень документации. Tagged инструкция по установке.

В папке установки хранится приложение, а в папке Data location, выбранной в мастере настройки, — исследовательские файлы и среды выполнения. Эти расположения настраиваются отдельно. После установки перейдите к первоначальной настройке.

Бег от источника

Вам нужны Git, Node.js 22, npm, и платформа создает предпосылки для Electron. Установите или выберите фреймворк агента в приложении. Во время установки репозиторий генерирует клиент Prisma, применяет патчи приложений и подготавливает собственные зависимости Electron.

Для установки воспроизводимого источника выберите предполагаемый тег выпуска от Изменить перед установкой зависимостей. Клон по умолчанию следует за ветвью, а не за фиксированным выпуском. Запишите выбранный тег, исходный код и версии выполнения, чтобы другой человек мог воспроизвести окружающую среду.

Замените RELEASE_TAG ниже точным тегом, показанным на выбранном релизе (включая его ведущий v). Вместо этого, чтобы следить за текущим развитием, опустите --branch RELEASE_TAG --depth 1. Эта проверка будет следовать за ветвью по умолчанию.

git clone --branch RELEASE_TAG --depth 1 https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev

Перед упаковкой производственной сборки запускайте:

npm run build

npm run build проверяет TypeScript, затем строит рендер Electron, предустановку и основные цели. Если вам нужно только протестировать веб-сайт или точку входа без головы, используйте существующие аргументы репозитория без головы с отдельным каталогом данных. Это удерживает тестовые данные из магазина по умолчанию.

Полная первоначальная настройка

Внешние сервисы и runtimes

Способность	Требуется?	Цель
OpenCode, Claude Agent, Codex или CodeBuddy	По крайней мере один	Проводит сеансы разговорных агентов
Типовой доступ	Требуется для агентских запросов	Поддерживаемая подписка или поставщик API; Доступ к подписке не требует отдельного ключа API
Python или R	необязательный	Запускает код ноутбука; использовать обнаруженную системную среду или среду, управляемую приложением
Доступ к сети	рекомендованный	Устанавливает среды выполнения и подключает провайдеров, GitHub, удаленные сервисы и MCP Connectors
хозяин SSH	необязательный	Запускает удаленные задания и извлекает результаты через панель вычислений

Местные данные

Мастер настройки показывает управляемое местоположение данных для больших исследовательских файлов, таких как артефакты, файлы Notebook и среды. Настройки приложений и история разговоров остаются в местоположении конфигурации. Перемещение местоположения данных исследования не является полной резервной копией приложения. Держите его отдельно от исходного хранилища; Используйте Хранилище, чтобы переместить его вместо ручного перемещения внутренних файлов во время работы приложения.

Подтвердите, что приложение готово

Открывается приложение, проходит необходимая проверка среды, устанавливается агент, проверяется доступ к модели. Настройка Python/R также требуется только для работы, которая выполняет эти языки. Открытие предварительного просмотра CSV или PDF не подтверждает время выполнения Notebook. Следуйте за Первый раз установка, затем за Поставщик и локальная настройка модели.

Проверьте обновления приложений

В Settings → General → About прочитайте установленную версию и используйте Check now для проверки доступности обновления. Проверьте указанную версию перед ее установкой и закончите сначала активную работу. Создание источника разработки может сообщать об обновлениях иначе, чем упакованная установка. Хранить копию важных экспортируемых результатов до обновления; не переименовывать внутренние каталоги данных приложения.

Если появится Установите Open-Science перед обновлением, приложение будет работать только с места чтения. Выберите Установить в «Программы» или переместите приложение в Finder. После установки используйте Перезапустить или выйдите из этой копии и снова откройте ее в Приложениях, а затем снова проверьте наличие обновлений. Продолжить работу сохраняет текущую копию открытой; Это не делает это местоположение обновляемым. Если установка не удалась, следуйте отображаемой ошибке перед повторным использованием.

Устранение неполадок установка и запуск

Где он проваливается	Первые проверки
Установщик рабочего стола или запуск приложения	Проверьте источник пакетов, архитектуру ОС и процессора, а затем прочитайте оперативную строку операционной системы.
Установка источника	Подтвердите node --version и npm --versionи это npm install Закончено. Повторите прерванную установку зависимости.
Первый раз установка	Прочитайте неудавшуюся проверку окружающей среды и устраните ее заявленное требование, прежде чем продолжить.
Первый агентский запрос	Подтвердить наличие активного/готового агента и запустить Test connection На странице модели.
Провайдер или локальное соединение браузера	Проверить зарегистрированную ошибку порта, прокси-сервера или сертификата; смотреть устранение неполадок.