# Open Science - 과학 AI 에이전트를 갖춘 오픈 소스 AI 연구 워크벤치
[](https://github.com/aipoch/open-science/releases/latest)
[](https://github.com/aipoch/open-science/releases/latest)
[](../../LICENSE)
[](https://aipoch.com/)
[](https://discord.gg/zxQAYjReRv)
> 이 문서는 영어 `README.md`의 번역본입니다. 내용이 다르면 [영문 원본](../../README.md)을 기준으로 합니다.
Open Science는 과학자와 연구자를 위한 오픈 소스이자 로컬 우선이며 모델에 구애받지 않는 AI 연구 워크벤치입니다. 과학 AI 에이전트, Python 및 R 실행, 과학 데이터 커넥터, macOS·Windows·Linux 크로스 플랫폼 지원을 통해 재현 가능하고 검토 가능한 연구를 수행합니다. 하나의 워크스페이스에서 프로젝트를 만들고 연구 목표를 자연어로 설명하면, 에이전트가 파일을 읽고 웹을 검색하며 코드를 실행하고 과학 데이터 소스를 조회하여 추적 가능한 출처가 포함된 보고서, 표, 그림을 생성합니다.
Open Science는 머신러닝, 통계학, 생명과학, 화학, 재료과학, 물리학, 환경과학을 비롯한 여러 분야의 계산 및 데이터 집약적 연구를 지원합니다. 문헌 검토와 가설 수립부터 코드 실행, 데이터 분석, 시뮬레이션, 시각화, 추적 가능한 연구 결과 생성까지 전체 연구 과정을 지원합니다.
> 💡 **[Open Science v0.18.2 출시](https://github.com/aipoch/open-science/releases/latest)** _(마지막 업데이트: 2026년 8월)_. Open Science v0.18.2는 러시아어 현지화, 대화 내보내기의 턴 선택, 사용자 지정 커넥터를 위한 사전 등록 OAuth 클라이언트를 도입합니다. 이와 함께 에이전트 목록 요약 축소, 대량 스트림 중 렌더러 응답성을 유지하는 증분 이벤트 어드미션 제한, 프로젝트 아티팩트 ZIP 스트리밍 내보내기, UTF-8 노트북 소스 디코딩을 갖춘 MCP 진행 하트비트, 메시지 편집 시 첨부 파일 보존, 불명확한 Codex 세션 복구, 멱등적 작업 API 생성, 그리고 다수의 작업 공간·노트북·업데이트·지속성 수정을 반영합니다. 자세한 내용은 [최신 릴리스 노트](https://github.com/aipoch/open-science/releases/latest)를 확인하세요.
## 목차
- [빠른 시작](#-빠른-시작)
- [제품 둘러보기](#제품-둘러보기)
- [Open Science를 선택하는 이유](#open-science를-선택하는-이유)
- [설계 원칙](#설계-원칙)
- [핵심 기능](#핵심-기능)
- [모델 제공업체](#모델-제공업체)
- [데이터, 권한 및 신뢰](#데이터-권한-및-신뢰)
- [프로젝트 상태](#프로젝트-상태)
- [개발 및 패키징](#개발-및-패키징)
- [로드맵](#로드맵)
- [AIPOCH 생태계와의 관계](#aipoch-생태계와의-관계)
- [Open Science가 아닌 것](#open-science가-아닌-것)
- [자주 묻는 질문](#자주-묻는-질문)
- [참여하기](#참여하기)
- [라이선스](#라이선스)
## 🚀 빠른 시작
세 단계로 Open Science를 실행할 수 있습니다. 플랫폼에 맞는 설치 프로그램을 다운로드하고, 안내에 따라 최초 실행 설정을 완료한 다음 연구 프로젝트를 만듭니다.
### 1. 앱 다운로드
[최신 릴리스](https://github.com/aipoch/open-science/releases/latest)를 열고 **Assets**를 펼친 다음 컴퓨터에 맞는 설치 프로그램을 선택하세요.
| 사용 중인 컴퓨터 | 선택할 파일 |
| ------------------------------ | ------------------------------------- |
| macOS — Apple Silicon(M1 이상) | Apple Silicon / ARM64용 macOS DMG |
| macOS — Intel | Intel / x64용 macOS DMG |
| Windows x64 | Windows x64 설치 프로그램 |
| Linux x64 | Linux x64 AppImage 또는 Debian 패키지 |
릴리스 페이지에 게시된 자산과 검증 정보를 확인하세요. 설치 전에 패키지를 검증해야 한다면 [다운로드 검증](../../SECURITY.md#verifying-your-download)을 참고하세요.
> macOS 또는 Windows에서 확인되지 않은 개발자나 알 수 없는 게시자 경고가 표시되면, 계속하기 전에 패키지가 공식 Releases 페이지에서 제공된 것인지 확인하세요.
### 2. 최초 설정 완료
처음 실행할 때 다섯 단계의 안내가 제공됩니다.
1. **환경**에서 호환성, 앱 저장소, 안전한 자격 증명 저장소, 네트워크 액세스를 확인합니다.
2. **에이전트 런타임**에서 Claude Code, OpenCode 또는 Codex를 선택하고 준비합니다. 앱 관리 런타임은 Node.js, npm 또는 관리자 암호 없이 설치할 수 있습니다.
3. **모델 제공업체**에서 사용할 모델에 연결하고 테스트합니다. 기본 제공업체, 사용자 지정 게이트웨이, 기존 Claude 또는 Codex 구독 로그인을 선택할 수 있습니다.
4. **Notebook 런타임**에서는 앱 관리 Python 및 R 환경을 선택적으로 준비하거나, 감지 또는 수동 등록한 각 언어 인터프리터를 활성화합니다.
5. **데이터 위치**에서 대용량 아티팩트, Notebook, 업로드, 환경의 저장 위치를 선택합니다.
호스트 호환성, 저장소 및 네트워크 검사
제공업체, API Key, 엔드포인트 및 모델 검증
Notebook 실행은 선택 사항입니다. 필수 환경 및 에이전트 런타임 검사를 모두 통과해야 `Continue`가 활성화되며, 모델 연결을 통과해야 설정을 완료할 수 있습니다. Notebook과 데이터 위치 설정은 기본값을 유지하고 나중에 설정에서 변경할 수 있습니다.
### 3. 연구 프로젝트 시작
1. **New project**를 클릭하고 프로젝트에 일관된 연구 이름과 선택적 설명을 지정합니다.
2. 세션을 열고 목표, 입력 데이터, 제약 조건, 원하는 결과, 결과를 확인할 방법을 설명합니다.
3. 원본 파일을 첨부하고 검증된 모델과 승인 모드를 선택합니다.
4. 작업을 보냅니다. 에이전트의 도구 활동을 확인하고 민감한 작업을 승인한 다음 생성된 아티팩트를 미리보기 패널에서 엽니다.
5. 다른 방향을 탐색하려면 이전 사용자 메시지를 편집해 새 브랜치에서 다시 보냅니다. 메시지 수정 컨트롤로 어느 경로든 다시 선택할 수 있습니다.
6. 아티팩트의 **Provenance** 보기를 열어 버전과 선택한 결과의 사용 가능한 증거를 확인합니다.
7. 이후 세션에서도 작업을 계속합니다. `@`로 기존 프로젝트 파일을 참조하고 `/`로 활성화된 스킬을 명시적으로 선택합니다.
> 이 README의 스크린샷은 워크플로를 설명하기 위한 예시입니다. 레이블, 카탈로그 및 기타 인터페이스 세부 사항은 설치한 버전과 다를 수 있습니다.
## 제품 둘러보기
Open Science는 연구를 프로젝트와 세션으로 구성하여 각 결과가 이를 만든 증거와 연결되도록 합니다. 다음 섹션에서는 워크스페이스, 아티팩트 출처, 미리보기, 과학 스킬, 데이터 커넥터를 소개합니다.
### 작업에서 추적 가능한 아티팩트까지 하나의 워크스페이스에서
프로젝트는 관련 세션, 업로드, 생성 파일, 미리보기 상태를 함께 보관합니다. 대화에는 에이전트의 답변과 그 답변을 만든 명령, 파일 읽기, 편집, 검색, 커넥터 호출이 기록됩니다. 생성된 각 아티팩트는 체크섬이 있는 불변 버전으로 저장됩니다. **Provenance** 보기에는 생성 당시 Open Science가 검증할 수 있었던 생성 코드와 실행 기록, 참조 입력, 관찰된 환경 인벤토리, 생성 대화 브랜치, 버전 범위 리뷰 결과가 표시됩니다. 누락된 증거는 추측하지 않고 사용할 수 없음으로 표시합니다.
프로젝트와 세션별로 구성된 업로드 및 생성 파일
데이터와 연구 기록을 나란히 보여 주는 기본 미리보기
생성된 보고서, 그림, 표는 세션에 연결된 상태로 프로젝트 파일 라이브러리에도 모입니다. 패널 크기가 변해도 미리보기 탭은 활성 결과를 표시하며, 긴 이름은 식별 가능한 접미사와 확장자를 유지합니다. Open Science는 일반 과학 데이터, PDF, Office 문서(DOCX, XLSX, PPTX), 확대/축소 및 이동이 가능한 이미지, 구문 강조 소스 코드, 분자 구조와 반응, Notebook 기록을 미리 봅니다. 미리보기 한도는 원본 파일을 자르지 않으므로 에이전트와 외부 도구가 전체 아티팩트를 계속 사용할 수 있습니다. `Cmd/Ctrl+F`로 워크스페이스 전체의 대화 기록, Notebook 출력, 렌더링된 페이지를 검색하거나 `Cmd/Ctrl+K`로 프로젝트 범위 명령 팔레트를 열 수 있습니다. **Settings → General**에서 테마를 전환하면 셸, 대화 기록, 렌더러 색상이 깜박임 없이 전환됩니다. 인터페이스는 설정의 런타임 언어 전환을 통해 중국어 간체·번체, 일본어, 한국어, 프랑스어, 러시아어로도 사용할 수 있습니다.
### 원본을 잃지 않고 대화 분기
완료된 사용자 메시지를 편집해 해당 지점에서 수정된 프롬프트를 다시 보낼 수 있습니다. Open Science는 후속 턴을 삭제하지 않고 새 메시지 브랜치를 만들며, 수정 컨트롤로 원래 경로와 대체 경로를 전환합니다. 브랜치 선택, 도구 활동, 첨부 파일, 생성 아티팩트는 프로젝트 전환과 앱 재시작 후에도 유지됩니다. 출처는 각 아티팩트 버전을 생성한 정확한 브랜치에 연결되므로 다른 가설을 탐색해도 이전 결과 기록이 흐려지지 않습니다.
### 과학 스킬 및 데이터 커넥터
Open Science에는 계속 확장되는 **18개의 주요** 파일 기반 연구 스킬이 있습니다. AlphaFold2, Boltz, Borzoi, Chai-1, DiffDock, Environment & Packages, ESM-2, ESMFold2, Evo 2, Indication Dossier, LigandMPNN, Literature Review, OpenFold3, ProteinMPNN, scGPT, scvi-tools, SolubleMPNN, 그리고 원격 HPC 클러스터에서 장시간 작업을 제출하고 결과를 가져오는 **Remote Compute (SSH)**입니다. 개인 스킬을 만들고, `SKILL.md`/ZIP/`.skill` 패키지를 업로드하며, 선택적 인증으로 GitHub의 호환 스킬을 미리 보고 가져오거나 전역 에이전트 디렉터리에 이미 설치된 스킬을 가져올 수 있습니다. 에이전트도 세션 첨부 파일이나 공개 GitHub URL에서 패키지 가져오기를 요청할 수 있으며, 앱 소유 미리보기와 확인 단계를 거친 후에만 내용을 씁니다. 활성화된 스킬은 작성창에서 `/`로 직접 선택할 수 있습니다.
또한 **24개의 기본 제공** 연구 커넥터가 있습니다. Literature Graph, PubMed, bioRxiv, Genes & Ontologies, Genomes, BioMart, Variants, Human Genetics, Clinical Genomics, Structures & Interactions, Protein Annotation, Expression, Omics Archives, CellGuide, Regulation, RNA, Chemistry, ChEMBL, ZINC, Molecule Viewer, Clinical Trials, Drug Regulatory, Cancer Models, Research Resources입니다. 기본 및 사용자 지정 커넥터는 권한 시스템으로 보호되며 각 도구에 `Always allow`, `Ask each time`, `Block`을 설정할 수 있습니다. 설치된 앱에는 현재 스킬, 커넥터, 도구 카탈로그가 표시됩니다.
읽고 재사용할 수 있는 연구 스킬
권한이 적용된 에이전트 도구로 제공되는 과학 데이터베이스
## Open Science를 선택하는 이유
Open Science는 연구 작업, 실행, 파일, 증거를 하나의 로컬 검토 가능 데스크톱 워크스페이스에 모읍니다.
연구 작업은 보통 채팅 창, Notebook, 로컬 스크립트, 과학 데이터베이스, 파일 브라우저, 보고 도구에 흩어집니다. 전달 과정마다 컨텍스트가 사라지고 답변은 이를 만든 코드와 파일에서 분리되기 쉽습니다.
Open Science는 이 요소들을 하나의 검토 가능한 데스크톱 워크스페이스에 통합합니다.
- **작업을 영구 보관합니다.** 프로젝트, 세션, 초안, 파일, 미리보기, 실행 기록이 앱 재시작 후에도 유지됩니다.
- **제안에 그치지 않고 실행합니다.** 사용자의 승인에 따라 에이전트가 명령, Python, R을 실행하고 파일 편집, 검색, 커넥터 호출, 아티팩트 생성을 수행합니다.
- **작업을 잃지 않고 대체 경로를 탐색합니다.** 이전 프롬프트를 새 메시지 브랜치에서 수정하고 서로 다른 연구 방향을 전환합니다.
- **결과를 추적할 수 있습니다.** 불변 아티팩트 버전은 Open Science가 검증할 수 있는 생성 증거를 보존하고 검증할 수 없는 증거를 명시합니다.
- **여러 모델을 선택할 수 있습니다.** 기본 클라우드 제공업체, 호환 사용자 지정 게이트웨이, Claude 또는 Codex 구독을 사용하고 작성창에서 모델과 추론 강도를 함께 선택합니다.
- **로컬 우선 소유권을 제공합니다.** 앱과 프로젝트 상태가 사용자 컴퓨터에서 실행되며 외부 호출은 명시적으로 구성하거나 승인한 서비스를 통해서만 발생합니다.
- **검토할 수 있습니다.** 소스 코드, 스킬, 커넥터 정의, 도구 활동, 생성 파일, 아티팩트 출처를 확인할 수 있습니다.
- **확장할 수 있습니다.** 폐쇄형 플러그인 로드맵을 기다리지 않고 스킬과 MCP 커넥터를 추가합니다.
- **좌석별 라이선스가 없습니다.** Open Science는 Apache-2.0 소프트웨어입니다. 선택한 모델이나 인프라 비용만 지불합니다.
Open Science는 처음부터 독립적으로 만든 제품입니다. 다른 AI 연구 앱의 프록시, 비공식 클라이언트, 외형만 바꾼 제품이 아닙니다.
## 설계 원칙
Open Science는 코드, 데이터, 모델, 사람의 감독이 결합되는 방식을 정하는 일곱 가지 원칙에 따라 설계되었습니다. 기본 공개, 명시적 다중 제공업체 호환성, 로컬 우선 데이터 소유권, 사람 참여 감독, 영구 연구 기록, 조합 가능한 기능, 정직한 과학적 경계입니다.
- **기본적으로 공개합니다.** 소스 코드, 형식, 커넥터, 스킬을 검토하고 포크할 수 있어야 합니다.
- **호환성을 명시하는 다중 제공업체를 지원합니다.** 모든 API 프로토콜을 서로 바꿀 수 있다고 간주하지 않고 제공업체 구성을 검증하며 엔드포인트 요구 사항을 표시합니다.
- **로컬을 우선하고 데이터를 고려합니다.** 프로젝트 상태를 로컬에 유지하고 외부 데이터 흐름을 표시하며 자율 동작은 사용자가 선택하도록 합니다.
- **사람이 과정에 참여합니다.** 파일 편집, 명령, 네트워크 액세스, 커넥터 호출은 명시적 승인 프로필의 통제를 받습니다.
- **연구 기록을 영구 보관합니다.** 세션, 도구 활동, Notebook 기록, 불변 아티팩트 버전을 실행 후에도 검토할 수 있으며 사용할 수 없는 증거를 명확히 밝힙니다.
- **기능을 조합할 수 있습니다.** 스킬, 커넥터, 모델, 미리보기, 향후 컴퓨팅 백엔드는 하나의 블랙박스가 아니라 교체 가능한 구성 요소여야 합니다.
- **과학적 경계를 정직하게 밝힙니다.** 생성 결과는 전문가 판단, 통계 검토, 원본 증거 검증을 대신하지 않습니다.
## 핵심 기능
Open Science는 프로젝트 관리, 다중 모델 에이전트 실행, Python 및 R Notebook, 과학 데이터 커넥터, 출처가 포함된 불변 아티팩트 버전, 권한이 적용된 사람 참여 제어를 하나의 로컬 워크스페이스에 통합합니다. 변경되는 카탈로그, 패키징 세부 정보, 새 옵션은 설치된 앱과 [최신 릴리스 노트](https://github.com/aipoch/open-science/releases/latest)를 기준으로 확인하세요.
| 영역 | 핵심 기능 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **프로젝트 및 세션** | 프로젝트 생성·이름 변경·삭제, 고정할 수 있는 여러 세션, 원래 후속 경로를 삭제하지 않고 완료된 프롬프트를 영구적이고 선택 가능한 메시지 브랜치로 편집, 세션 안의 영구 사이드 대화, 최근 작업·초안·대화 기록·미리보기 상태 복원. |
| **에이전트 워크플로** | 자연어 작업, 스트리밍 응답, 선언된 목적별 형식화 도구 활동 카드, 범주별 추정이 있는 실시간 컨텍스트 사용량, 요청 시 컨텍스트 압축, 재시작 후 상태 보존, 중지 및 승인 일시 정지, 실행 중 종료 확인과 저장되는 설정, 후속 메시지를 대기시키는 작성창 메시지 대기열, 완료된 에이전트 메시지에서 새 세션 분기, 주의 사유가 있는 데스크톱 알림·영구 미확인 배지·차단 승인 기본 알림, 읽음 상태와 삭제된 대상을 보존하는 알림 센터, 여러 질문을 위한 구조화 확인 카드, 홈의 실시간 세션 상태, 경과 시간과 사용량이 포함된 메시지 메타데이터, 턴별 토큰 사용량, 완료된 턴의 프레임워크와 모델 표시, 프로젝트 범위 명령 팔레트·프레임 읽기·프로젝트 작업·에이전트 컨텍스트, 개선된 세션 행, 영구 실행 계약과 CLI 계획 보기·승인·거부가 있는 리뷰 게이트 세션 계획, 매끄러운 실시간 렌더링, 접을 수 있는 사이드 패널, 새 대화 단축키, 앱 재시작으로 중단된 세션 복구. |
| **서브에이전트 위임** | 영구 메시지와 복구를 갖춘 프로덕션 서브에이전트 위임. |
| **모델** | 기본 클라우드 제공업체, 사용자 지정 호환 게이트웨이, Claude 및 Codex 구독 로그인, 연결 검증, 모델별 멀티모달 이미지 입력, 모델과 지원 추론 강도를 합친 작성창 선택기, 에이전트 프로세스를 다시 연결하지 않는 호환 모델 및 제공업체 핫 스위치, 텍스트 전용 백엔드를 위한 영구 이미지 증거 릴레이가 있는 전용 Vision 모델 선택기. 제공업체와 API 형식은 선택한 에이전트 백엔드에 맞춰 검증됩니다. |
| **에이전트 백엔드** | 하나의 워크스페이스를 여러 기반 에이전트 구현에서 실행하는 선택 가능 에이전트 프레임워크, 백엔드에 따른 제공업체 및 모델 검증, 설정에서 앱 관리 백엔드 설치·전환·제거, 전환 또는 재개 후 각 프레임워크의 컨텍스트 경로를 따르는 에이전트 인식 재생. |
| **스페셜리스트** | 범위 지정 기능이 있는 개인 스페셜리스트 에이전트 프로필, 메인 에이전트에서 실행 중 즉시 인계, 대화식 사용자 지정, 패키지 가져오기/내보내기, 불변 호출 ID, 검증 가능한 재정의를 포함한 이름 기반 ID 생성, 서명 검증·공식 및 사용자 승인 GitHub 소스·CDN 폴백·다운로드 진행률·가져오기 시 스킬 충돌 해결을 제공하는 범위 지정 스페셜리스트 마켓플레이스. 마켓플레이스는 설치됨과 마켓플레이스 뷰를 분리하고, 검증된 캐시 목록을 즉시 표시하며 수동 새로고침을 지원합니다. 세부 정보에서 바로 설치할 수 있고, 공유 기능 아이콘·외관 빠른 편집·기능 행 탐색을 제공합니다. |
| **기능 구성** | 스킬·커넥터·실행 가능한 스페셜리스트에 적용되는 리소스 간 태그, 보호된 즐겨찾기 태그, 할당 메뉴, 배지, 필터, 검색 가능한 태그 설정 브라우저, 포인터 또는 키보드를 사용한 영구 드래그 정렬. |
| **실행** | 영구 코드/출력 기록이 있는 Python·R·REPL 제어 영역 커널, 같은 실행 기록에 저장되는 무상태 셸 명령, 에이전트 평가용 제한된 REPL 추론, 오프라인 프로비저닝을 지원하는 앱 관리 환경, 사용자 Python·R 인터프리터, 키 또는 비밀번호 인증과 OS 암호화 자격 증명 저장을 지원하는 추가 실행 대상인 원격 SSH 컴퓨팅 호스트, 에이전트와 공유하는 사용자 터미널, 런타임 환경별 읽기 전용 설치 패키지 목록, 에이전트 파일 검사용 Notebook 아티팩트 읽기. 외부 R 런타임의 패키지 관리는 수동입니다. |
| **입력 및 파일** | 파일당 최대 10 GB 스트리밍 첨부, 인덱스 페이지 매김·세션 그룹·소스 범위 파일명 검색·그리드/목록 보기·대규모 프로젝트 모달이 있는 프로젝트 라이브러리, 세션 옆 분할 파일 미리보기, 생성 아티팩트 카드, 기존 업로드/결과의 `@` 참조, 드라이브 간 탐색·편집 가능한 경로 표시줄·드라이브 전환을 포함한 로컬 폴더 액세스용 `@path` 멘션, 다운로드/내보내기, 선택적 세션 아티팩트 다운로드, Markdown/PDF 대화 내보내기, 탭별 또는 전체 `.ipynb` 세션 내보내기. |
| **아티팩트 및 출처** | 체크섬, 사용 가능한 생성 코드, 실행 기록, 정확한 입력 참조, 환경 인벤토리, 생성 메시지 브랜치 컨텍스트, 아티팩트 계보 액세스, 버전 범위 리뷰 증거가 있는 불변 세션 범위 아티팩트 버전. 버전 탐색과 관련 증거의 직접 링크를 지원합니다. |
| **미리보기 형식** | 일반 과학 데이터, PDF, Office 문서(DOCX, XLSX, PPTX), TIFF를 포함한 확대/축소 및 이동 가능 이미지, 구문 강조 소스 코드, 분자 구조와 반응, Notebook 기록의 반응형 다중 탭 미리보기. 인라인 또는 전체 화면 보기와 아티팩트 생성 대화로 돌아가는 컨텍스트 탐색을 지원합니다. |
| **로컬 데이터 관리** | 로컬 프로젝트 및 앱 데이터, 구성 가능한 저장 위치, 안내식 마이그레이션, 시스템·수동·직접 모드의 전역 프록시 설정, 기간 요약·30일 활동 히트맵·일별 입력/캐시/출력 차트가 있는 토큰 사용량 대시보드. |
| **스킬** | **18개의 주요** 기본 스킬, 불변 소문자 하이픈 이름을 갖는 개인 스킬, 세션 내 자연어 대화를 통한 생성, 완료된 대화 턴에서 스킬로 저장, 외부 패키지 검증을 포함한 직접 사용자 스킬 폴더, 소스·상태·텍스트 필터가 있는 일괄 활성화/비활성화 관리, 패키지 업로드, 인증된 GitHub 미리보기/가져오기, 후보 미리보기가 있는 전역 설치 스킬 가져오기, 첨부 파일이나 GitHub URL에서 에이전트가 요청한 패키지 가져오기, 구조화 검증을 포함한 camelCase Host JavaScript API, 활성화/비활성화 제어, 세션의 `/` 명시 선택. 재설계된 스킬 패널은 메인 에이전트와 스페셜리스트 필터를 통합하고, 실제 사용자 아바타 스택과 제한된 '사용 중' 팝오버를 표시하며, 행 작업을 통합하고, 기본 및 스페셜리스트 연결 스킬을 보호하면서 확인된 일괄 삭제를 지원합니다. |
| **커넥터** | 런타임 상태 및 복구 화면을 갖춘 **24개의 기본** 연구 커넥터, 편집 가능한 표시 이름과 분리된 불변 소문자 호출 이름을 쓰는 로컬/원격 MCP 커넥터, 검증 가능한 재정의가 있는 이름 기반 로컬 ID, 연락처 메타데이터, 커넥터/도구별 권한. 카탈로그 상호작용은 스킬과 같은 간결한 관리 패턴을 따릅니다. |
| **안전 제어** | `Ask for approval`, `Auto-approve edits`, `Full access` 대화 프로필, 코드 미리보기와 호출/대화 결정을 포함한 승인 대화상자, 필터·행별/계열별 취소·실행 취소가 있는 영구 전역/프로젝트/세션 범위 허용 권한, 커넥터/도구별 정책. |
| **리뷰 및 검증** | 완료된 턴을 자체 대화 기록·실행 로그·아티팩트와 대조해 감사하고 pass/warn/fail 결과 및 제한된 수정 루프를 제공하는 선택적 리뷰어, 활성 모델을 따르거나 전용 제공업체·모델·추론 강도로 고정하는 리뷰어 모델 정책, 수정 귀속을 유지하는 영구 리뷰 평가 스냅샷. |
| **배포 및 지원** | macOS, Windows, Linux 설치 프로그램, 환경·에이전트 런타임·모델 제공업체·Notebook 런타임·데이터 위치를 위한 간결한 최초 실행 마법사, 프랑스어·중국어 간체·중국어 번체·일본어·한국어·러시아어 인터페이스, 지원 언어별 README 번역, 그 밖의 다국어 기여 가이드, 눈에 띄는 업데이트 알림이 포함된 업데이트 안내, 로컬 진단, 커뮤니티 링크. |
## 모델 제공업체
Open Science는 제품 수준에서 특정 모델에 종속되지 않습니다. 주요 클라우드 LLM 제공업체 또는 사용자 지정 게이트웨이에 연결하거나 기존 Claude 또는 Codex 구독을 재사용할 수 있습니다. 현재 제공업체 사용 가능 여부는 선택한 에이전트 백엔드와 지원 API 프로토콜에 따라 달라집니다. 모델에 연결하는 방법은 네 가지입니다.
| 제공업체 모드 | 작동 방식 |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **기본 클라우드 제공업체** | 설치된 앱에 표시된 제공업체 목록에서 선택하고 요청된 키로 인증합니다. |
| **사용자 지정 게이트웨이** | 호환되는 Base URL, API Key, 정확한 모델 ID를 입력합니다. 기본 API 형식(Messages, Chat Completions 또는 Responses)은 활성 에이전트 프레임워크에서 결정되므로 새 사용자 지정 게이트웨이를 바로 사용할 수 있습니다. |
| **Codex 구독** | 먼저 Codex 에이전트 프레임워크를 선택하면 제공업체 유형에서 Codex 구독을 선택할 수 있습니다. |
| **Claude 구독** | 두 가지 모드로 로그인합니다. **공유** 모드는 브라우저 로그인 자격 증명을 기본 `~/.claude` 프로필에 저장합니다. **격리** 모드는 앱 소유 `CLAUDE_CONFIG_DIR`에서 `claude setup-token`을 실행하여 `~/.claude/`와 완전히 분리하고 브라우저 흐름과 토큰 붙여넣기 폴백을 제공합니다. |
기존 **Local Claude** 제공업체는 제거되었습니다. 저장된 Local Claude 항목은 업그레이드 중 삭제됩니다. **Claude Subscription**을 추가하고 공유 브라우저 로그인 또는 격리된 `claude setup-token` 흐름으로 인증하세요.
기본 클라우드 공급업체에는 OpenAI, Anthropic, Grok (xAI), DeepSeek, 전용 GLM Coding Plan 엔드포인트가 있는 Zhipu AI (GLM), Kimi (Moonshot), MiniMax, 전용 Step Plan 구독 엔드포인트가 있는 StepFun, Xiaomi MIMO, SenseNova, Volcengine Ark, 전용 Bailian for Plan 구독 엔드포인트가 있는 Bailian (Alibaba Cloud), OpenRouter 통합 게이트웨이 등이 있으며 일부는 지역에 따라 다릅니다.
제공업체, 사용 가능한 모델, 지역 엔드포인트는 이 README와 별개로 변경될 수 있습니다. 설치된 앱의 제공업체 선택기와 연결 테스트를 최신 정보의 기준으로 삼으세요.
## 데이터, 권한 및 신뢰
Open Science는 프로젝트 데이터, 설정, 아티팩트 버전, 출처 증거를 로컬 컴퓨터에 저장합니다. API Key는 로컬에 보관되며 운영 체제에서 지원할 경우 보안 자격 증명 저장소로 보호됩니다. 로그는 로컬에 있고 자동으로 업로드되지 않습니다.
외부 데이터 흐름은 발생할 수 있으므로 검토해야 합니다.
- 모델 요청은 프롬프트와 필요한 컨텍스트를 선택한 모델 제공업체로 보냅니다.
- 웹 검색과 원격 커넥터는 표시된 매개변수를 외부 서비스로 보냅니다.
- 로컬 커넥터는 컴퓨터에서 신뢰할 수 있는 명령을 실행할 수 있습니다.
- 첨부 파일, `@` 참조, 로그, 생성 보고서에는 민감한 연구 데이터가 포함될 수 있습니다.
작업에 맞는 가장 제한적인 권한 프로필을 선택하세요.
| 모드 | 동작 | 권장 용도 |
| -------------------- | --------------------------------------------------------------- | -------------------------------------------------- |
| `Ask for approval` | 편집, 명령, 네트워크, 커넥터 호출 전에 확인 | 새 워크플로, 민감한 데이터, 익숙하지 않은 스크립트 |
| `Auto-approve edits` | 워크스페이스 편집은 자동 허용하고 명령, 네트워크, 커넥터는 확인 | 외부 액세스를 제어하는 신뢰할 수 있는 파일 편집 |
| `Full access` | 편집, 명령, 네트워크, 커넥터를 자동 허용 | 범위가 명확하고 완전히 신뢰하는 무인 작업 |
승인 전에 커넥터 매개변수와 도구 활동을 검토하세요. API Key, 액세스 토큰, 환자 식별자, 미공개 데이터, 민감한 로컬 경로를 스크린샷이나 공개 이슈 로그에 포함하지 마세요.
## 프로젝트 상태
Open Science는 macOS, Windows, Linux에서 사용할 수 있으며 활발히 개발되는 데스크톱 앱입니다. 신뢰할 수 있는 로컬 우선 연구 워크플로, 확장 가능한 과학 기능, 추적 가능한 연구 아티팩트, 사용자 제어 실행에 중점을 둡니다.
현재 다운로드와 버전별 변경 사항은 [최신 릴리스](https://github.com/aipoch/open-science/releases/latest)를 확인하세요. 제공됨, 일부 구현됨, 계획됨 상태의 기능은 [기능 맵](../../ROADMAP.md#capability-map)을 참고하세요.
Open Science는 연구 실행과 기록 보관을 지원하지만 연구자는 방법, 해석, 개인정보 보호, 과학적 타당성에 대한 책임을 집니다.
## 개발 및 패키징
Open Science는 React, TypeScript, Prisma/SQLite, ACP 기반 에이전트 런타임으로 구축된 Electron 앱입니다.
소스 개발 요구 사항:
- Node.js LTS 이상과 npm
- Git
- Notebook을 실행할 때만 Python 3
```bash
git clone https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev
```
`npm install`은 Prisma 클라이언트를 자동 생성하고 Electron 네이티브 종속성을 설치합니다. `npm run dev`는 Electron main/preload 번들을 빌드하고 렌더러를 시작하여 데스크톱 앱을 엽니다. 개발 데이터는 `~/.open-science-project`에 격리됩니다.
유용한 명령:
| 명령 | 용도 |
| ---------------------- | ------------------------------------ |
| `npm run dev` | 개발 앱 시작 |
| `npm run dev:web` | 개발 앱 + localhost 웹 UI(127.0.0.1) |
| `npm run dev:headless` | Electron 창 없는 개발 백엔드 + 웹 UI |
| `npm run lint` | ESLint 실행 |
| `npm run typecheck` | main 및 renderer 코드 타입 검사 |
| `npm test` | Vitest 모음 실행 |
| `npm run build` | 타입 검사 및 앱 빌드 |
| `npm run build:web` | 선택적 localhost 웹 UI 빌드 |
| `npm run build:mac` | macOS 빌드 패키징 |
| `npm run build:win` | Windows 빌드 패키징 |
| `npm run build:linux` | Linux 빌드 패키징 |
패키지 출력은 `dist/`에 기록됩니다.
### Localhost 웹 및 헤드리스 모드
데스크톱 백엔드는 로컬 컴퓨터의 브라우저에 동일한 렌더러를 선택적으로 제공할 수 있습니다. 이 기능은 기본적으로 꺼져 있고 `127.0.0.1`에만 바인딩됩니다.
```bash
npm run build:web
npm run dev:web
```
앱에 출력된 인증 URL을 여세요. `npm run dev:headless`를 사용하면 Electron 창을 열지 않고 백엔드, 트레이, 에이전트 런타임, localhost 웹 서비스를 시작합니다. `OPEN_SCIENCE_WEB_PORT`로 포트를 선택할 수 있습니다(기본값 `44100`). 앱을 명시적으로 종료하면 에이전트와 Notebook 프로세스도 정상적으로 종료됩니다.
### 모바일 원격 액세스
Remote.It 페어링을 통해 휴대전화나 태블릿에서 동일한 localhost 웹 UI에 연결할 수 있습니다. 6자리 Open Science 코드로 브라우저를 페어링하고 데스크톱에서 한 번 승인하면 루프백 서버를 직접 공개하지 않고 워크스페이스에 연결할 수 있습니다. 브라우저 신뢰는 취소할 수 있으며 모드 변경이나 서비스 종료는 활성 원격 세션을 즉시 무효화합니다.
### 헤드리스 CLI 및 SDK
헤드리스 CLI와 종속성이 없는 Node.js SDK는 데스크톱 및 웹 인터페이스와 같은 로컬 데몬, 프로젝트, 세션, 자격 증명, 권한을 사용합니다. 자세한 사용법은 게시 가능 패키지와 함께 관리하므로 하나의 명령 참조만 유지합니다.
- [CLI 가이드](../../packages/open-science/CLI.md) — 설치, 서비스 수명 주기, 작업 자동화, 아티팩트, 출력 형식, 종료 코드
- [SDK 패키지 개요](../../packages/open-science/README.md) — Node.js 빠른 시작 및 패키지 진입점
## 로드맵
제품 로드맵과 기능 상태는 [ROADMAP.md](../../ROADMAP.md)에서 관리합니다. 이 README는 계속 변하는 우선순위나 릴리스 목표 목록을 중복해서 제공하지 않습니다.
## AIPOCH 생태계와의 관계
[AIPOCH](https://aipoch.com/open-science)([GitHub 조직](https://github.com/aipoch))는 Open Science를 오픈 과학 AI 워크플로의 데스크톱 오케스트레이션 계층으로 개발합니다.
- [aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)는 500개 이상의 파일 기반 의료 및 과학 연구 스킬을 제공하는 더 큰 컬렉션입니다. 모든 스킬을 검토하고 가져와 GitHub에서 Open Science와 함께 사용할 수 있습니다.
- Open Science는 프로젝트/세션 워크스페이스, 에이전트 런타임, 실행, 아티팩트, 미리보기, 권한, 커넥터를 제공하여 이러한 지침을 대화형 워크플로로 바꿉니다.
스킬과 커넥터는 코드를 실행하거나 데이터를 외부로 보낼 수 있습니다. 활성화하기 전에 소스, 라이선스, 스크립트, 네트워크 동작을 검토하세요.
## Open Science가 아닌 것
Open Science는 연구 실행과 기록 보관 도구이며 일반 채팅 래퍼, 비공식 클라이언트, 과학적 검토의 대체재가 아닙니다.
- **단순한 채팅 UI가 아닙니다.** 영구 프로젝트, 실행, 파일, 아티팩트, 검토할 수 있는 도구 활동을 중심으로 구성됩니다.
- **다른 제품의 비공식 클라이언트가 아닙니다.** 자체 코드베이스, 데이터 모델, 인터페이스, 로드맵을 갖춘 독립 구현입니다.
- **과학적 판단을 대신하지 않습니다.** 결과에는 분야별 검토, 통계 검증, 원본 자료와의 대조가 여전히 필요합니다.
## 자주 묻는 질문
### Open Science를 처음 열면 무엇을 해야 하나요?
답변: **Environment**, **Agent runtime**, **Model provider**, **Notebook runtime**, **Data location**의 다섯 설정 단계를 완료하세요. `Action needed`로 표시된 필수 항목을 해결하고, 선택한 에이전트의 설치 또는 복구가 제안되면 수행한 다음 모델 연결을 테스트하세요. Notebook 설정과 사용자 지정 데이터 위치는 선택 사항입니다.
### API Key란 무엇이며 어디에서 받나요?
답변: API Key는 모델 제공업체가 발급하는 비밀 자격 증명입니다. 제공업체의 개발자/API 콘솔에서 만들거나 복사하세요. 이 키를 사용하는 요청에 요금이 청구될 수 있습니다. 암호처럼 취급하고 공유하거나 저장소에 커밋하지 마세요.
### API Key가 필요한가요?
답변: 기존 구독 로그인을 재사용하면 필요하지 않습니다. 공유 브라우저 로그인이나 앱이 관리하는 격리된 `claude setup-token` 흐름으로 Claude 구독을 사용하거나, Codex 백엔드에서 ChatGPT/Codex 구독으로 로그인할 수 있습니다. 기본 클라우드 제공업체와 사용자 지정 게이트웨이에는 각각의 키가 필요합니다.
### 어떤 모델 제공업체를 사용할 수 있나요?
답변: 설정 중 또는 `Settings → Model`에서 제공업체 선택기를 열어 설치된 앱과 선택한 에이전트 백엔드가 지원하는 옵션을 확인하세요. 기본 클라우드 제공업체, 호환 Custom Gateway, 공유 또는 격리 로그인 방식의 Claude 구독, Codex 백엔드의 Codex 구독을 사용할 수 있습니다.
### 모델 연결 테스트가 실패하는 이유는 무엇인가요?
답변: API Key에 빠진 문자나 공백이 없는지, Base URL과 지역이 올바른지, 제공업체의 정확한 모델 ID를 사용했는지 확인하고 네트워크 연결과 계정 잔액도 확인하세요. Claude 구독은 선택한 모드에 따라 공유 브라우저 로그인을 다시 시도하거나 격리된 `claude setup-token` 자격 증명을 갱신하세요.
### 설정 중 `Continue`가 비활성화되는 이유는 무엇인가요?
답변: 현재 단계의 필수 조건이 충족되지 않았습니다. 해당 단계에 따라 `Action needed` 환경 항목을 해결하거나, 선택한 에이전트 런타임을 설치 또는 복구하거나, 모델 제공업체를 검증하세요. Notebook 설정은 선택 사항이며 Notebook 실행에만 영향을 줍니다.
### 설정을 마쳤습니다. 연구 작업을 어떻게 시작하나요?
답변: 프로젝트를 만들거나 열고 세션을 시작한 다음 원본 파일을 첨부하고 목표, 제약 조건, 예상 결과, 검증 기준을 설명하세요. `@`로 프로젝트 파일을 참조하고 `/`로 활성화된 스킬을 선택하세요.
### 원격 HPC 클러스터에서 작업을 실행하려면 어떻게 하나요?
답변: **Settings → Skills**에서 **Remote Compute (SSH)** 스킬을 활성화하고, **Settings → Compute**에서 클러스터를 등록한 다음 세션을 시작해 `/remote-compute-ssh`로 스킬을 선택하세요. 스킬은 호스트 등록, SSH를 통한 짧은 명령, 완전 비동기 작업 제출을 처리합니다. 작업이 완료되면 앱이 자동으로 분석 턴을 시작하므로 폴링 루프를 작성할 필요가 없습니다.
### 명령줄 인터페이스가 있나요?
답변: 있습니다. **Settings → General → Command line tool → Install command**에서 한 번에 설치할 수 있습니다(`open-science`를 PATH에 추가하며 별도 Node.js가 필요하지 않습니다). CLI는 브라우저를 열지 않고 로컬 서비스를 제어하고 연구 작업을 제출합니다.
```bash
# 백그라운드에서 서비스 시작
open-science start --no-open
# 프로젝트를 만들고 정확한 이름으로 작업 실행
open-science project create "Systematic review"
open-science run --project "Systematic review" \
--prompt-file ./task.md \
--approval-profile auto \
--skill literature-review \
--wait --json
# 생성된 아티팩트 다운로드
open-science artifacts list --json
open-science artifacts download --output ./report.md
```
전체 명령 참조, JSON/JSONL 출력 형식, 종료 코드, 헤드리스 서비스 옵션은 [CLI 가이드](../../packages/open-science/CLI.md)를 참고하세요.
### 생성된 결과의 출처를 확인하려면 어떻게 하나요?
답변: 생성된 아티팩트를 열고 **Provenance**를 선택하세요. 버전을 선택하여 콘텐츠 ID와 사용 가능한 생성 코드, 실행 기록, 입력, 환경 인벤토리, 생성 대화 컨텍스트, 리뷰 증거를 확인합니다. Open Science가 검증할 수 없는 증거는 사용할 수 없음으로 표시됩니다.
### 이후 대화를 잃지 않고 이전 요청을 수정할 수 있나요?
답변: 가능합니다. 완료된 사용자 메시지를 편집해 다시 보내면 해당 지점에서 새 브랜치가 생성됩니다. 원래 후속 턴은 계속 사용할 수 있고, 메시지 옆의 수정 화살표로 대체 경로를 전환합니다.
### 연구 데이터가 내 컴퓨터에 남나요?
답변: 프로젝트, 세션, 파일, 설정, 구성된 자격 증명은 기본적으로 로컬에 저장됩니다. 모델 요청, 웹 검색, 커넥터 호출에 필요한 내용은 선택한 외부 서비스로 전송될 수 있으므로 작업을 실행하기 전에 민감한 입력과 제공업체 정책을 검토하세요.
## 참여하기
Open Science는 GitHub, Discord, X 및 AIPOCH 웹사이트를 통해 버그 신고, 기능 제안, 설계 토론, 커뮤니티 질문 및 기여를 받습니다. 목적에 가장 잘 맞는 채널을 선택하고 프로젝트 세부 정보를 공개하기 전에 관련 기여 가이드와 공개 게시 안전 안내를 확인하세요.
| 채널 | 용도 |
| ------------------------------------------------------------------------ | ------------------------------------------ |
| [GitHub Issues](https://github.com/aipoch/open-science/issues) | 버그, 재현 가능한 오류, 구체적인 기능 제안 |
| [GitHub Discussions](https://github.com/aipoch/open-science/discussions) | 설계 질문, 로드맵 제안, 긴 기술 토론 |
| [Discord](https://discord.gg/zxQAYjReRv) | 커뮤니티 지원, 기여자 조율, 비공식 토론 |
| [X / @aipoch_ai](https://x.com/aipoch_ai) | 릴리스 발표 및 공개 개발 업데이트 |
| [웹사이트](https://aipoch.com/) | 제품 개요, 다운로드 및 AIPOCH 생태계 |
공개 이슈를 만들기 전에 로그와 스크린샷에서 API Key, 토큰, 비공개 파일 경로, 미공개 데이터, 환자 식별자 및 기타 민감한 정보를 제거하세요. 개발 워크플로는 [기여 가이드](CONTRIBUTING.md)를 참고하세요.
> ⭐ **저장소에 Star:** 이 프로젝트가 도움이 되었다면 GitHub에서 Star를 남겨 주세요. Star는 지속적인 개발에 힘이 됩니다. 몇 초면 충분하지만 프로젝트에는 큰 의미가 있습니다.
## 라이선스
Apache License 2.0 — [LICENSE](../../LICENSE)를 참고하세요.
