project-nomad

Project NOMAD는 자체 포함된 오프라인 우선 지식 및 교육 서버입니다. Debian 기반 시스템(Ubuntu 26.04 LTS 권장, 24.04 LTS 및 Debian 12도 지원)에 터미널 기반 스크립트로 설치되며, 모든 도구는 브라우저를 통해 접근하므로 데스크톱 환경이 필요하지 않습니다. 빠른 설치는 apt와 curl 파이프 설치 스크립트를 사용하며, 고급 경로는 수동 구성을 위한 Docker Compose 템플릿을 제공합니다. 설치 후 Command Center는 localhost 또는 기기 IP의 8080 포트에서 접근할 수 있습니다. 아키텍처 및 운영: NOMAD는 Docker를 통해 컨테이너화된 도구와 리소스 모음을 오케스트레이션하는 관리 UI("Command Center")와 API입니다. 이러한 구성 요소의 설치, 구성 및 업데이트를 처리합니다. 설정 마법사는 큐레이션된 콘텐츠 컬렉션으로 첫 구성을 안내하며, Wikipedia 콘텐츠 선택기, ZIM 라이브러리 관리자, 콘텐츠 탐색기와 같은 내장 도구가 있습니다. README에 설명된 내장 기능: - 지식 베이스가 있는 AI 채팅: Ollama 또는 LM Studio, llama.cpp와 같은 OpenAI 호환 서버로 구동되는 로컬 AI 채팅으로, 문서 업로드 및 의미 검색(Qdrant를 통한 RAG)을 지원합니다. - 정보 라이브러리: Kiwix를 통한 오프라인 위키백과, 의학 참고 자료, 전자책 등. - 교육 플랫폼: Kolibri를 통한 진행 상황 추적 및 다중 사용자 지원이 포함된 Khan Academy 강좌. - 오프라인 지도: ProtoMaps를 통한 다운로드 가능한 지역 지도. - 데이터 도구: CyberChef를 통한 암호화, 인코딩, 해싱 및 분석. - 메모: FlatNotes를 통한 로컬 마크다운 메모 작성. - 시스템 벤치마크: Builder Tags 및 커뮤니티 리더보드를 통한 하드웨어 점수. - Supply Depot: 원클릭 앱 카탈로그(PDF 도구, 파일 브라우저, 전자책 라이브러리, 비밀번호 관리자 등)와 사용자 지정 Docker 컨테이너 실행 기능. - 자동 업데이트: 핵심 소프트웨어, 설치된 앱 및 오프라인 콘텐츠에 대한 선택적 예약 업데이트; 부 버전/패치 자체 업데이트는 쿨오프 기간 후 구성 가능한 시간 창에서 사전 점검을 통과한 경우에만 발생할 수 있으며, 주요 버전은 수동 업데이트가 필요합니다. 하드웨어: 관리 애플리케이션 자체는 가벼우며 최소 사양은 2GHz 듀얼 코어 프로세서, 4GB RAM, 최소 5GB 여유 디스크 공간 및 Debian 기반 OS입니다. 인터넷은 설치 중에만 필요합니다. LLM 및 기타 AI 도구 실행은 GPU 지원 기기에서 권장되며, 최적 사양은 Ryzen 7 또는 Core i7 이상, 32GB RAM, NVIDIA RTX 3060 또는 AMD 동급 이상, 가능하면 SSD에 최소 250GB 여유 공간입니다. AI 모델은 AI 어시스턴트 설정을 Ollama 또는 OpenAI 호환 API URL로 지정하여 다른 호스트에서 실행할 수 있습니다. 원격 Ollama의 경우 서버를 OLLAMA_HOST=0.0.0.0으로 시작해야 합니다. 개인정보 보호 및 연결성: NOMAD는 오프라인 사용을 위해 설계되었으며 내장 원격 측정(텔레메트리)이 전혀 없다고 명시합니다. 인터넷은 초기 설치와 사용자가 선택하는 이후 다운로드에만 필요합니다. 연결 확인은 먼저 Cloudflare의 1.1.1.1 trace 엔드포인트를 시도하고, 앱이 이미 접촉하는 엔드포인트(GitHub API 및 Project NOMAD API)로 폴백합니다. 테스트 URL은 설정의 고급(Advanced)에서 또는 INTERNET_STATUS_TEST_URL 환경 변수를 통해 재정의할 수 있으며, 환경 변수가 우선합니다. 보안 자세: 설계상 이 프로젝트는 인증을 포함하지 않으며 로컬 네트워크에서 개방형으로 사용하도록 되어 있습니다. README는 네트워크 수준 제어를 권장하고 인스턴스를 인터넷에 직접 노출하지 말 것을 권고합니다. 선택적 인증은 공개 로드맵에서 추적되는 향후 기능으로 언급됩니다. 유지 관리 및 개발: /opt/project-nomad의 헬퍼 스크립트는 스택을 시작, 중지, 업데이트 및 제거합니다. 업데이트 스크립트는 Command Center 컨테이너만 새로 고치며, 설치 가능한 애플리케이션 컨테이너는 UI를 통해 업데이트됩니다. 기여자의 경우 Ace 명령("auto-update:dry-run")은 업데이트를 트리거하지 않고 전체 자동 업데이트 결정 파이프라인을 실행하여 결정적 시나리오 스위트, 라이브 GitHub 릴리스 시뮬레이션, 고정된 시계와 사전 준비된 릴리스 목록을 사용한 완전 오프라인 실행을 지원합니다. 이 프로젝트는 Apache License 2.0으로 라이선스되며 웹사이트, Discord 커뮤니티, 벤치마크 리더보드, FAQ 및 커뮤니티 애드온 문서를 제공합니다.