프로젝트 소개

ClioForge는 역사학자, 인문학 연구자 및 AI 에이전트를 위해 설계된 셀프 호스팅 오픈 소스 연구 IDE입니다. 원본 문서, 독서 노트, 증거 및 연구 작업을 하나로 통합하여 해석이 소스 자료와 연결되고 인간의 검토를 받도록 하는 것을 목표로 합니다. 이 프로젝트는 개인적인 오픈 소스 실험이며, 호스팅 서비스는 제공되지 않으므로 사용자는 자신의 컴퓨터에서 실행하거나 자신의 Cloudflare 계정에 배포해야 합니다. 주요 기능으로는 PDF, 이미지, 텍스트 가져오기 또는 Google Drive에서 파일 선택하기가 있으며, 원본은 비공개로 유지되고 전사 버전이 보존됩니다. 사용자는 페이지를 읽고 하이라이트하며 주석을 달 수 있으며, 구절을 안정적인 소스, 버전 및 페이지 참조가 포함된 증거로 변환할 수 있습니다. 풍부한 에디터는 표, 그림 및 LaTeX를 지원하며, 버전을 비교하고 인용구가 포함된 글을 내보낼 수 있습니다. 검토된 주장과 증거는 장별 진행 상황, 소스 참조, 커버리지 확인 및 최종 인간 검토가 포함된 제한적 원고 초안으로 변환될 수 있습니다. 연구 질문, 상충하는 해석 및 증거는 드래그 가능한 작업 보드와 검토 가능한 어시스턴트 결과로 정리할 수 있습니다. 제한된 추출, 비교 및 연구 워크플로우는 사용자가 제공한 모델 API 키를 사용하여 실행되며, 실행 과정, 종속성 및 예상 비용을 추적합니다. 백그라운드 연구 도시에 워크플로우는 소스별 읽기, 교차 비판 및 소스 연결 합성을 지원하며 인간의 검토로 마무리됩니다. 협업 기능으로는 프로젝트 초대, 역할 및 작업 토론, 프로젝트 백업 내보내기 및 복구가 포함됩니다. 인터페이스는 영어와 중국어로 제공되며 라이트 및 다크 테마를 지원합니다. 상태: 셀프 호스팅 알파 버전입니다. 자동화된 테스트와 선택된 엔드-투-엔드 연구 연습이 중요한 워크플로우를 다루지만, 모든 아카이브, 모델 또는 기관에 대한 신뢰성을 보장하지는 않습니다. 시맨틱 검색은 텍스트를 대상으로 하며 이미지 유사도는 지원하지 않습니다. Zotero 가져오기는 지속적인 동기화 방식이 아닙니다. 예약된 문헌 모니터링은 제한된 Crossref 메타데이터 세트를 확인합니다. 지출 제어는 제공업체의 청구 한도가 아닌 추정치를 사용합니다. 로컬 복구 초안은 브라우저별로 저장됩니다. Google 통합, 이메일 및 모델 호출은 별도의 설정이 필요합니다. 로컬 실행을 위해서는 Git과 Node.js 22.19 이상 버전이 필요합니다. 로컬 D1, R2 및 Queues는 에뮬레이션되므로 Cloudflare 계정이 필요하지 않습니다. 설정 과정은 저장소 클론, 종속성 설치, 비밀 설정, 마이그레이션 실행 및 개발 서버 시작으로 구성됩니다. 로컬 런타임은 루프백 전용이며 보안이 강화된 공용 서버가 아닙니다. 영구적인 호스팅을 위해 셀프 호스팅 가이드가 제공되며, 일반적인 Docker/VPS 프로덕션 백엔드는 현재 제공되지 않습니다. 아키텍처: UI와 HTTP API는 React, Vinext 및 Cloudflare Workers를 사용합니다. 인증은 D1에 기록되는 Better Auth를 사용합니다. 프로젝트, 버전, 참조 및 작업은 Drizzle 마이그레이션을 사용하는 D1/SQLite를 사용합니다. 원본 파일은 비공개 R2에 저장되며 인증된 API를 통해 제공됩니다. 백그라운드 연구 및 모니터링은 Queues, 별도의 Worker 및 Cron Triggers를 사용합니다. 트랜잭션 이메일은 Cloudflare Email Sending을 사용합니다. 모델 액세스는 저장 시 암호화되는 사용자 제공 API 자격 증명을 사용합니다. 애플리케이션 코드는 출처를 기록하고, 액세스를 제어하며, 버전을 추적하고, 보류 중인 결과와 수락된 연구를 분리합니다. 라이선스: 원본 애플리케이션 코드는 AGPL-3.0-only이며, 제3자 구성 요소는 별도의 라이선스를 따릅니다. 이 프로젝트는 독립적이며 Prove2Me 코드를 포함하거나 이에 의존하지 않습니다.