설치 및 업데이트

대부분의 사용자는 GitHub 릴리스에서 데스크탑 패키지를 설치해야 합니다. 기여자 또는 최신 코드를 테스트하는 사람이 소스에서 앱을 실행할 수 있습니다. Electron 데스크톱 클라이언트는 공용 Node 백엔드에 연결하여 정통 로컬 브라우저 인터페이스를 제공합니다.

Platform

macOSWindowsLinux

Your choice is kept across chapters.

현재 포장: v1.0.5 Assets 데스크톱 설치, 독립 CLI 아카이브 및 Linux CLI 포함 .deb/.rpm 패키지. 예정된 설치 유형 및 아키텍처를 선택하고 같은 릴리스에서 체크섬을 확인합니다. 데스크톱 발사기는 사용할 수 있습니다. Settings → General → Command line tool → Install command.

설치방법 선택

데스크톱 설치 프로그램 다운로드

1. Open-Science 출시을 엽니다.
2. 운영 체제 및 CPU 아키텍처와 일치하는 패키지를 다운로드하십시오.
3. installer와 complete installation에 의해 표시된 라이센스를 읽어, 그 다음 앱을 시작합니다. 5 단계 설정 마법사가 첫 번째 실행에 열립니다.
4. 운영 체제가 서명되지 않은 응용 프로그램을 차단하면 공식 AIPOCH GitHub 저장소에서 다시 다운로드하고 소스를 검사 한 후 플랫폼의 보안 프롬프트를 따르십시오.

릴리스에 첨부된 투자정보에서 선택하면 자동으로 생성된 소스 코드 ZIP이 아닙니다. Availability는 해당 공개 자산에 달려 있습니다.

(주)아이디	건축의 식별	패키지 및 설치
macOS, 애플 실리콘	이 맥에 대해 Apple M-series 칩을 보여줍니다.	제품 정보 mac-arm64.dmg; 응용 프로그램에 응용 프로그램을 드래그 한 다음 그것을 실행
macOS, 인텔	이 맥에 대해 인텔 프로세서를 보여줍니다	제품 정보 mac-x64.dmg; 적용분야 응용 프로그램은 macOS 12 이상 필요

Homebrew로 설치

Homebrew로도 설치할 수 있습니다:

brew install --cask open-science

Homebrew는 Apple Silicon 또는 Intel을 자동으로 선택합니다. 설치 후, Settings → General → About을 열고 설치 된 버전을 확인; 패키지 관리자는 문서 기본보다 더 새로운 릴리스를 해결할 수 있습니다. 태그 설치 지침.

설치 위치에는 애플리케이션을 저장하고, 설정 마법사의 Data location에는 연구 파일과 실행 환경을 저장합니다. 두 위치는 별도로 설정합니다. 설치 후 초기 설정을 진행하세요.

독립 CLI 사용

터미널/browser 설치를 위해, 일치 독립 CLI 아카이브를 다운로드 v1.0.5· 노드, 백엔드 및 웹 UI를 묶습니다. 완전한 디렉토리를 추출 한 다음 따르십시오. 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 패키지

리눅스 맨끝/browser 사용을 위해, 선택하십시오 open-science-cli, 별도로 aipoch-open-science 데스크탑 패키지. 일치하는 패키지를 다운로드하고 CLI-PACKAGE-SHA256SUMS.txt 와 v1.0.5 Assets, 그 후에 설치하기 전에 확인합니다.

유통/건축	v1.0.5 CLI 자산
데비안 / 우분투, x64	open-science-cli_1.0.5_amd64.deb
데비안 / 우분투, 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, 백엔드 및 웹 UI. Python/R을 설치하지 않거나 자동으로 시스템 서비스를 시작하지 않습니다. OS credential 상점과 sandbox prerequisites는 아직도 적용합니다; 헤드리스 Linux 자격 참조. 데스크톱 발사기가 설치되면 open-science-cli을 명시적으로 사용하십시오.

격상시키기 전에 또는 포장, 끝 일 및 정지를 제거하십시오 모든 프로파일은 그 패키지에 의해 시작· apt/dnf를 통해 다음 다운로드 패키지를 설치; 이 설치에 의해 구성 된 AIPOCH apt/dnf 저장소가 없습니다. 포장 제거는 연구 자료와 credentials를 보존합니다. 더 보기 공식 패키지 가이드 명령 충돌 및 플랫폼 요구 사항을 설명합니다.

소스에서 실행

당신은 Git, Node.js 24, npm 및 Electron에 대한 플랫폼 빌드 prerequisites가 필요합니다. 응용 프로그램에서 에이전트 프레임 워크를 설치 또는 선택. 설치 중에 저장소는 Prisma Client를 생성하고 앱 패치를 적용하고 Electron native Dependencies를 준비합니다.

reproducible 근원 임명을 위해, 를 선택하십시오 공지사항 의존성을 설치하기 전에. 기본적으로 clone은 고정 릴리스보다는 분기를 따릅니다. 선택된 태그, 소스 커밋 및 런타임 버전을 기록하므로 다른 사람이 환경을 재현 할 수 있습니다.

선택된 릴리즈에 표시된 정확한 태그로 아래 RELEASE_TAG을 대체하십시오. (v)를 포함합니다. 지속적인 개발을 따르기 위하여 대신, omit --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 및 사용 독립 실행 시간 안내 그것의 구조 표적 및 의존성을 위해. npm run dev:web Node/Web 항목 포인트를 개발; npm run dev 또한 데스크톱 클라이언트를 준비합니다. 고립 된 구성 디렉토리를 사용하여 테스트 데이터를 분리합니다.

첫 번째 시간 설정 완료

외부 서비스 및 실행 시간

공급 능력	견적 요청	제품정보
OpenCode, Claude Agent, Codex 또는 CodeBuddy	적어도 하나	대화 에이전트 세션을 실행
모델 접근	에이전트 요청에 필요한	지원되는 구독 또는 API 공급자; 구독 액세스는 별도의 API 키가 필요하지 않습니다.
Python 또는 R	옵션 정보	노트북 코드를 실행; 감지 시스템 환경 또는 앱 관리 환경 사용
네트워크 액세스	(주)	런타임을 설치하고 공급자, GitHub, 원격 서비스 및 MCP 커넥터를 연결
SSH 호스트	옵션 정보	Compute panel을 통해 원격 작업 및 검색 결과를 실행합니다.

지역 정보

설정 마법사는 artifacts, Notebook 파일 및 환경과 같은 큰 연구 파일에 대한 관리 된 데이터 위치를 보여줍니다. Application 설정 및 대화 기록은 구성 위치에 남아 있습니다. 연구 데이터 위치가 전체 애플리케이션 백업이 아닙니다. 소스 저장소에서 분리 유지; 저장소을 사용하여 앱이 실행되는 동안 수동으로 내부 파일을 이동 대신 재구성합니다.

앱이 준비되어 있는지 확인하십시오.

신청은, 필수 환경 체크 통행, 대리인 설치되고, 모형 접근은 확인됩니다. Python/R 설정은 해당 언어를 실행하는 작업에만 추가적으로 필요합니다. CSV 또는 PDF 미리보기를 열고 Notebook 실행 시간을 유효하지 않습니다. 첫 번째 시간 설정, 공급자 및 지역 모델 설정을 따르십시오.

자주 묻는 질문

Settings → General → About에서 설치 된 버전을 읽고 Check now을 사용하여 업데이트 가용성을 확인하십시오. 설치하기 전에 나열된 버전을 검사하고 활성 작업을 먼저 완료합니다. 개발 소스 빌드는 패키지 설치에서 다르게 업데이트 할 수 있습니다. 갱신의 앞에 중요한 수출한 결과의 사본을 지키십시오; 애플리케이션의 내부 데이터 디렉토리를 변경하지 마십시오.

1.0에서 open-science update이 제거됩니다. 데스크톱 컨트롤 또는 공식 설치 프로그램을 통해 앱을 업데이트하고, 설치자 / 패키지 관리자를 통해 CLI 설치를 업데이트하십시오. Check now이 아직 공개된 릴리스를 제공하지 않는 경우, 공식 릴리스 페이지를 확인하십시오. 구성을 삭제하거나 앱을 재설정하지 않습니다 업데이트 채널.

업데이트하기 전에 Open-Science를 설치하세요이 나타나면 앱이 읽기 전용 위치에서 실행됩니다. 응용 프로그램에 설치을 선택하거나 Finder에서 앱을 이동하십시오. 설치 후, 다시 시작을 사용하거나이 복사를 종료하고 응용 프로그램에서 하나를 다시 열면 다시 업데이트를 확인합니다. 계속 사용는 현재 사본을 엽니다 지킵니다; 그것은 그 위치 업데이 트 할 수 없습니다. 설치가 실패한 경우, 다시 시도하기 전에 표시된 오류를 따르십시오.

문제 해결 설치 및 시작

그것이 실패하는 곳	첫 번째 체크
데스크톱 설치자 또는 앱 출시	패키지 소스, OS 및 CPU 아키텍처를 확인 한 다음 운영 체제를 읽습니다.
소스 설치	이름 * node --version 으로 npm --version, 그리고 그 npm install 완료. 중단된 의존성 임명을 재기하십시오.
초기 설정	실패한 환경 검사를 읽고 계속하기 전에 명시된 요구 사항을 해결하십시오.
첫 번째 에이전트 요청	Active/Ready Agent를 확인하고 실행하십시오. Test connection 모형 페이지에.
공급자 또는 지역 브라우저 연결	보고된 항구, 프록시 또는 증명서 과실을 검열하십시오; 은 은 문제 해결.

v0.31.0 후에 제품 naming

현재 인터페이스 및 새로운 패키지 사용 Open-Science 지속적으로. Upgrading는 기존의 설치 이름과 위치, 연구 자료, 자격 및 설정을 보존합니다. Open Science을 포함하는 오래된 임명 경로는 격상 실패 자체에 의해 아닙니다; 새 디스플레이 이름과 일치하는 데이터 폴더를 변경하지 마십시오.

1.0로 업그레이드하고 호환성을 이해

1. 구성 디렉토리를 다시 완료하고 별도로 구성 된 데이터 위치. 하나의 .science 수출은 전체 프로필의 백업이 아닙니다.
2. 설치를 사용하여 데스크톱 / 백엔드 인스턴스를 닫고, 공식 설치 프로그램을 통해 업그레이드합니다. 원본 프로파일, 데이터 및 OS 자격 저장을 보존합니다.
3. 오픈 및 버전, 프로젝트, 세션, 파일, 모델 및 런타임을 계속 확인하십시오. 이진 downgrade는 뒤 자료를 구하지 않습니다; 이전의 binaries는 더 새로운 저장된 데이터를 읽지 않을 수 있습니다.

1.0 기존의 역사적인 업그레이드 및 수입 경로 유지; 버전 번호는 프로필 재설정이 필요하지 않습니다. 더 보기 1.x 호환성 정책 문서화된 CLI/SDK 및 작업 자동화 인터페이스를 커버하고, 검증된 수입 .science 패키지 및 지원된 프로필 업그레이드. OS-protected credentials의 동일한 모형 대답, 제삼자 가용성 또는 deterministic 재생산을 보장하지 않습니다. Security Fixes는 최신 안정된 출시를 목표로 합니다.

npm으로 CLI 설치

Node.js 사용 22.13 이상 을 공개 CLI·백엔드 패키지에 사용합니다. 터미널에서 설치하고 호출된 버전을 확인하세요:

npm install --global @aipoch/[email protected]
open-science version --json
open-science help

그런 다음 터미널 설정 절차에 따라 프로필을 초기화하고 백엔드를 시작한 뒤 모델을 설정하세요. 설치만으로 로그인하거나 Python/R이 설치되지는 않습니다. 데스크톱·Homebrew 실행기가 같은 명령을 사용하면 셸이 선택한 실행 파일부터 확인하세요. 업데이트 전에 해당 설치본의 모든 백엔드를 중지하고, 프로필을 유지한 채 원래 패키지 관리자로 업데이트합니다.

다운로드부터 설치 완료까지 확인

설정 Settings → General → About, 선택 Check now 그리고 제안된 출시를 검토합니다. 업데이트 대화 상자는 다운로드 진행 상황을 유지, 메모 및 설치 준비를 함께 해제. 다운로드 완료는 설치 완료되지 않습니다 : relaunch 후 설치된 버전을 확인합니다.

해당 채널에서 자동 설치를 사용할 수 없다고 표시되면 다운로드한 패키지를 보관하고 실행 중인 작업을 마친 뒤 공식 설치 파일을 사용하세요. v1.0.5에서도 자동 교체 제한은 유지됩니다. Windows 진행 표시 개선은 이 제한을 없애지 않습니다. Notebook 정리 중에는 앱을 강제 종료하지 마세요.

업데이트 수동 설치

업데이트 창에서 Installation instructions를 엽니다. 패키지가 없으면 Download from website를, 확인된 다운로드가 있으면 운영체제에 맞게 Show in Finder, Show in File Explorer, Show in file manager를 사용합니다. 앱 종료 중에도 해당 폴더를 열어 둡니다.

작업을 저장하고 진행 중인 설치나 정리가 끝날 때까지 기다립니다. macOS는 DMG 또는 압축 파일을 열어 Applications의 Open-Science를 교체합니다. Windows는 기존 설치 폴더를 사용합니다. Linux는 맞는 DEB를 설치하거나 AppImage를 교체하고 실행 권한을 유지합니다. 실제 패키지 형식에 맞는 안내를 따르세요.

파일이 없어지거나 변경되면 다시 다운로드합니다. 위치 표시는 설치 실행이 아닙니다. 다시 실행한 뒤 Settings → General → About에서 버전, 원래 프로젝트와 데이터를 확인합니다. 독립 CLI를 교체하기 전 대상 서비스가 모두 중지되었는지 확인합니다.