Установка и обновления
Большинство пользователей должны установить пакет рабочего стола из GitHub Releases. Участники или любой, кто тестирует новейший код, могут запустить приложение из источника. Клиент рабочего стола Electron подключается к общему серверу Node, который также обслуживает аутентифицированный локальный интерфейс браузера.
Текущие пакеты: v1.0.5 Assets Включает десктопные установщики, автономные архивы CLI и Linux CLI .deb/.rpm Пакеты. Выберите предполагаемый тип установки и архитектуру, а затем проверьте контрольную сумму из того же выпуска. Десктопная пусковая установка остается доступной через Settings → General → Command line tool → Install command.
Выберите метод установки
Скачать десктопный установщик
- Открыть Open-Science выпустили.
- Загрузите пакет, который соответствует вашей операционной системе и архитектуре процессора.
- Прочитайте лицензию, показанную установщиком, и заполните установку, затем запустите приложение. Пятиступенчатый мастер настройки открывается на первом пробеге.
- Если операционная система блокирует неподписанное приложение, скачайте его снова из официального репозитория 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 инструкция по установке.
Официальные установщики Windows подписаны кодом v0.33.2; v0.33.3 расширяет подпись на пакетные исполняемые файлы. Скачайте из Официальная страница загрузки или GitHub выпустили и следуйте официальным заметкам проверки, чтобы проверить источник пакета.
| компьютер | Определите архитектуру | Упаковка и установка |
|---|---|---|
| Windows | Настройки → Система → О → Тип системы | Выберите соответствие win-…-setup.exe; запустить установщик текущего пользователя и следовать его указаниям местоположения |
- Откройте загруженный установщик Windows и перейдите на страницу расположения установки.
- Сохраните местоположение по умолчанию или выберите Browse…, чтобы выбрать папку для приложения, а затем выберите Install.
- Дождитесь страницы завершения. Оставьте выбранный вариант запуска и выберите Finish, чтобы открыть Open-Science.
- Следуйте за Первый раз установка, чтобы проверить среду и настроить местоположение данных, агент и модель.
| компьютер | Определите архитектуру | Упаковка и установка |
|---|---|---|
| Ubuntu / Debian | uname -m: x86_64 означает x64, aarch64 Что такое ARM64 | Выберите соответствие .deb, откройте его с установщиком системного пакета, затем запустите из меню приложения |
| Поддерживаемые дистрибутивы Linux | Проверить uname -m | Выберите соответствие .AppImage, разрешить выполнение в разрешениях файла, затем открыть его; Устранение любой ошибки зависимости, сообщенной дистрибутивом |
v1.0.5 для Linux x64 и ARM64 Пакеты. Для ARM64 выберите aipoch-open-science-1.0.5-linux-arm64.AppImage или aipoch-open-science_1.0.5_arm64.deb. X64-я модель является aipoch-open-science-1.0.5-linux-x86_64.AppImage и aipoch-open-science_1.0.5_amd64.deb. Скачать из выбранного релиза официальные Активы и соответствовать результату uname -m.
В папке установки хранится приложение, а в папке Data location, выбранной в мастере настройки, — исследовательские файлы и среды выполнения. Эти расположения настраиваются отдельно. После установки перейдите к первоначальной настройке.
Используйте автономный CLI
Для установки терминала / браузера скачайте соответствующий автономный архив CLI из v1.0.5. Он объединяет узел, бэкэнд и веб-интерфейс. Извлеките полный каталог, затем следуйте Настройка CLI. Держите CLI и бэкэнд от одной и той же установки вместе.
Домашний джекпот CLI
Установите или управляйте Homebrew CLI brew install aipoch/tap/open-scienceОтдельно от рабочего стола. Проверьте версию, фактически предлагаемую Homebrew; формула может отставать от релиза GitHub. Установка не запускает системный сервис. Если пусковые установки конфликтуют, проверьте type -a open-science и использовать "$(brew --prefix aipoch/tap/open-science)/bin/open-science" Для этой установки.
Пакеты Linux CLI
Для использования терминала/браузера Linux выберите open-science-cliотдельно от того, что aipoch-open-science Десктопный пакет. Скачать соответствующий пакет и CLI-PACKAGE-SHA256SUMS.txt из v1.0.5 AssetsЗатем проверьте перед установкой.
| Распределение/архитектура | v1.0.5 Актив CLI |
|---|---|
| Debian / Ubuntu, x64 | open-science-cli_1.0.5_amd64.deb |
| Debian / Ubuntu, ARM64 | open-science-cli_1.0.5_arm64.deb |
| Федора, x64 | open-science-cli-1.0.5-1.x86_64.rpm |
| Федора, ARM64 | open-science-cli-1.0.5-1.aarch64.rpm |
Установите загруженный файл с соответствующим менеджером пакетов. В этих примерах используется x64; При необходимости используйте имя файла ARM64.
# 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
Запустите open-science-cli start --no-open, затем open-science-cli status --json. После запуска используйте open-science-cli url для открытия аутентифицированного локального веб-интерфейса. Держите этот URL приватным. Продолжайте с Настройка CLI для конфигурации модели и проверки doctor, заменив open-science на open-science-cli в этих командах.
Пакет объединяет Node, бэкэнд и веб-интерфейс. Он не устанавливает Python/R и не создает автоматически запущенную системную службу. Предпосылки для хранения учетных данных ОС и песочницы по-прежнему применяются; См. Безголовые учетные данные Linux. Используйте open-science-cli явно, когда установлена настольная пусковая установка.
Перед обновлением или удалением пакета завершите работу и остановитесь. Каждый профиль, начатый этим пакетом. Установите следующий загруженный пакет через apt/dnf; нет репозитория AIPOCH apt/dnf, настроенного этой установкой. Удаление пакета сохраняет данные исследований и учетные данные. The Официальный путеводитель Описывает командные конфликты и требования платформы.
Бег от источника
Вам нужны Git, Node.js 24, 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
Используйте выбранный тег package.json и Отдельный Runtime Guide Для построения целей и зависимостей. npm run dev:web Разрабатывает точку входа Node/Web; npm run dev Также готовит настольный клиент. Используйте изолированный каталог конфигурации для разделения тестовых данных.
Полная первоначальная настройка
Внешние сервисы и 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 для проверки доступности обновления. Проверьте указанную версию перед ее установкой и закончите сначала активную работу. Создание источника разработки может сообщать об обновлениях иначе, чем упакованная установка. Хранить копию важных экспортируемых результатов до обновления; не переименовывать внутренние каталоги данных приложения.
Из 1.0 удаляется open-science update. Обновите приложение с помощью элементов управления рабочим столом или официального установщика и обновите установку CLI через менеджер установщика / пакета, которому оно принадлежит. Если Check now еще не предлагает опубликованный релиз, проверьте официальную страницу релиза. Удаление конфигурации или сброс приложения не будет способствовать обновлению канала.
Если появится Установите Open-Science перед обновлением, приложение будет работать только с места чтения. Выберите Установить в «Программы» или переместите приложение в Finder. После установки используйте Перезапустить или выйдите из этой копии и снова откройте ее в Приложениях, а затем снова проверьте наличие обновлений. Продолжить работу сохраняет текущую копию открытой; Это не делает это местоположение обновляемым. Если установка не удалась, следуйте отображаемой ошибке перед повторным использованием.
Переустановка сохраняет существующие данные. Если вам необходимо начать работу с новой информацией после проблемы с данными, см. Сброс локальных данных Windows. Этот отдельный инструмент удаляет данные; Это не является частью обычного обновления.
Устранение неполадок установка и запуск
| Где он проваливается | Первые проверки |
|---|---|
| Установщик рабочего стола или запуск приложения | Проверьте источник пакетов, архитектуру ОС и процессора, а затем прочитайте оперативную строку операционной системы. |
| Установка источника | Подтвердите node --version и npm --versionи это npm install Закончено. Повторите прерванную установку зависимости. |
| первоначальной настройке | Прочитайте неудавшуюся проверку окружающей среды и устраните ее заявленное требование, прежде чем продолжить. |
| Первый агентский запрос | Подтвердить наличие активного/готового агента и запустить Test connection На странице модели. |
| Провайдер или локальное соединение браузера | Проверить зарегистрированную ошибку порта, прокси-сервера или сертификата; смотреть устранение неполадок. |
Название продукта после v0.31.0
Современный интерфейс и новые пакеты используют Open-Science. Модернизация сохраняет существующие названия и местоположения установки, данные исследований, учетные данные и настройки. Более старый путь установки, содержащий Open Science, сам по себе не является отказом от обновления. не переименовывать и не перемещать свои папки данных в соответствии с новым именем дисплея.
Обновление до 1.0 и понимание совместимости
- Завершите активное исследование и резервное копирование каталога конфигурации плюс любое отдельно настроенное местоположение данных. Один экспорт
.scienceне является резервной копией всего профиля. - Закройте экземпляры рабочего стола / бэкэнда с помощью установки, а затем обновите через официальный установщик. Сохранить оригинальный профиль, данные и хранилище учетных данных ОС.
- Откройте и проверьте версию, проекты, сессии, файлы, модели и время выполнения, прежде чем продолжить. Бинарное понижение не откатывает данные; Старые двоичные файлы могут не читать новые сохраненные данные.
1.0 сохраняет существующие исторические пути обновления и импорта; номер версии не требует сброса профиля. The Политика совместимости 1.x охватывает документированные интерфейсы автоматизации CLI/SDK и Task, форвардный импорт .science пакеты и поддерживаемые обновления профиля. Он не гарантирует идентичные ответы на модели, доступность для третьих сторон или детерминированное воспроизведение всей исследовательской сессии или кроссплатформенную передачу учетных данных, защищенных ОС. Решения безопасности нацелены на последний стабильный выпуск.
Установите CLI с помощью npm
Используйте Node.js 22.13 или позже для опубликованного пакета CLI/backend. В терминале установите и проверьте использованную версию:
npm install --global @aipoch/[email protected]
open-science version --json
open-science help
Затем следуйте настройка терминала для инициализации профиля, запуска его бэкэнда и настройки модели. Установка сама по себе не регистрирует вас или не устанавливает Python / R. Если десктоп или пусковая установка Homebrew уже использует одно и то же имя команды, проверьте, какой исполняемый файл выберет ваша оболочка, прежде чем продолжить. Остановите каждый бэкэнд, принадлежащий установке, прежде чем обновлять эту установку; сохраните свой профиль и обновите его через исходный менеджер пакетов.
Следите за обновлениями до установки
в Settings → General → AboutВыберите Check now Просмотреть предлагаемый релиз. Диалог обновлений поддерживает прогресс загрузки, выпуск заметок и подготовку установки вместе. Завершение загрузки не является завершением установки: проверьте установленную версию после перезапуска.
Если приложение говорит, что автоматическая установка недоступна для этого канала, сохраните загруженный пакет и используйте официальный установщик после завершения активной работы. Каналы установки v1.0.5 по-прежнему ограничивают автоматическую замену; улучшенный диалог прогресса Windows не устраняет это ограничение. Не заставляйте приложение закрываться, пока идет очистка ноутбука.
Установите обновление вручную
В диалоге обновления откройте Installation instructions. Использовать Download from website Если у вас нет пакета. Для подтвержденного загруженного установщика выберите Show in Finder, Show in File Explorer или Show in file managerВ зависимости от платформы. Держите эту папку открытой, выходя из приложения.
Сохраните работу и дождитесь завершения активной установки или очистки перед запуском другого установщика. На macOS откройте DMG или отсоедините пакет и замените Open-Science в приложениях. В Windows запустите установщик, используя существующую папку установки. В Linux установите соответствующий DEB или замените AppImage и сохраните исполняемое разрешение. Следуйте инструкциям для вашего фактического формата пакета.
Если установщик отсутствует или изменился, загрузите его снова; раскрытие пакета не запускает его. Открыть открытую науку и проверить Settings → General → AboutПодтвердите свои оригинальные проекты и данные. При обновлении отдельных файлов CLI сначала Проверить, что все пострадавшие службы остановлены.