Crosstalk-Solutions/project-nomad

Project N.O.M.A.D.는 언제 어디서나 정보를 얻고 역량을 강화할 수 있도록 필수적인 도구, 지식, 그리고 AI가 포함된 독립형 오프라인 우선 (offline-first) 지식 및 교육 서버입니다.

Project N.O.M.A.D.는 모든 Debian 기반 운영체제(Ubuntu 권장)에 설치할 수 있습니다. 설치는 완전히 터미널 기반 (terminal-based)으로 이루어지며, 모든 도구와 리소스는 브라우저를 통해 액세스하도록 설계되었습니다. 따라서 N.O.M.A.D.를 "서버"로 설정하고 다른 클라이언트를 통해 접속하고자 한다면 데스크톱 환경 (desktop environment)은 필요하지 않습니다.

참고: 설치 스크립트를 실행하려면 sudo/root 권한이 필요합니다

sudo apt-get update && \
sudo apt-get install -y curl && \
curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh \
...

Project N.O.M.A.D.가 이제 장치에 설치되었습니다! 브라우저를 열고 http://localhost:8080 (또는 http://DEVICE_IP:8080)으로 이동하여 탐색을 시작하세요!

단계별 전체 안내(Ubuntu 설치 포함)를 보려면 설치 가이드 (Installation Guide)를 참조하십시오. Windows 사용자의 경우, 네이티브 Docker 및 Docker Desktop 설치 경로를 다루는 커뮤니티 지원 방식인 WSL2 설치 가이드를 참조하십시오.

설치 프로세스를 더 세밀하게 제어하려면 Docker Compose 템플릿을 docker-compose.yml 파일에 복사하여 붙여넣고 원하는 대로 맞춤 설정하십시오 (모든 플레이스홀더(placeholder)를 실제 값으로 교체해야 합니다). 그런 다음 docker compose up -d를 실행하여 커맨드 센터 (Command Center)와 그 종속성들을 시작하십시오. 참고: 이 방법은 시작 전 Docker에 대한 숙련도와 수동 설정이 필요하므로 고급 사용자에게만 권장됩니다.

N.O.M.A.D.는 Docker를 통해 컨테이너화된 (containerized) 도구 및 리소스 모음을 오케스트레이션 (orchestrate)하는 관리 UI ("Command Center") 및 API입니다. 모든 것에 대한 설치, 구성 및 업데이트를 처리하므로 사용자가 직접 할 필요가 없습니다.

내장된 기능은 다음과 같습니다:

지식 베이스를 활용한 AI 채팅 (AI Chat with Knowledge Base)— Ollama를 통해 구동되는 로컬 AI 채팅을 제공하며, LM Studio 또는 llama.cpp와 같이 OpenAI API와 호환되는 소프트웨어를 사용할 수도 있습니다. 문서 업로드 및 시맨틱 검색 (Qdrant를 통한 RAG) 기능을 포함합니다.

정보 라이브러리 (Information Library)— Kiwix를 통해 오프라인 Wikipedia, 의학 참조 자료, 전자책 등을 제공합니다.

교육 플랫폼 (Education Platform)— Kolibri를 통해 학습 진도 추적이 가능한 Khan Academy 코스를 제공합니다.

오프라인 지도 (Offline Maps)— ProtoMaps를 통해 다운로드 가능한 지역 지도를 제공합니다.

데이터 도구 (Data Tools)— CyberChef를 통해 암호화, 인코딩 및 분석 기능을 제공합니다.

노트 (Notes)— FlatNotes를 통해 로컬 노트 작성을 지원합니다.

시스템 벤치마크 (System Benchmark)— 커뮤니티 리더보드가 포함된 하드웨어 점수 측정 기능을 제공합니다.

간편 설정 마법사 (Easy Setup Wizard)— 큐레이션된 콘텐츠 컬렉션과 함께 처음 사용자를 위한 가이드형 구성을 제공합니다.

N.O.M.A.D.에는 Wikipedia 콘텐츠 선택기, ZIM 라이브러리 관리자, 콘텐츠 탐색기와 같은 내장 도구도 포함되어 있습니다.

기능	구동 엔진	제공 내용
정보 라이브러리	Kiwix	오프라인 Wikipedia, 의학 참조 자료, 생존 가이드, 전자책
...

많은 유사한 오프라인 생존용 컴퓨터들이 최소한의 가벼운 하드웨어에서 구동되도록 설계된 것과 달리, Project N.O.M.A.D.는 정반대입니다. 사용 가능한 AI 도구들을 설치하고 실행하기 위해서는, 설치 환경을 최대한 활용할 수 있도록 GPU가 탑재된 고성능 장치를 사용하는 것을 강력히 권장합니다.

하지만 핵심적으로 N.O.M.A.D.는 여전히 매우 가볍습니다. 관리 애플리케이션 자체의 최소 설치를 위해서는 다음과 같은 최소 사양이 필요합니다:

• 프로세서: 2 GHz 듀얼 코어 프로세서 이상
• RAM: 4GB 시스템 메모리
• 저장 공간: 최소 5 GB 이상의 여유 디스크 공간
• OS: Debian 기반 (Ubuntu 권장)
• 안정적인 인터넷 연결 (설치 시에만 필요)

LLM 및 기타 포함된 AI 도구들을 실행하려면:

• 프로세서 (Processor): AMD Ryzen 7 또는 Intel Core i7 이상
• RAM: 32 GB 시스템 메모리
• 그래픽 (Graphics): NVIDIA RTX 3060 또는 AMD 동급 이상의 제품 (VRAM이 많을수록 더 큰 모델을 실행할 수 있습니다)
• 저장 공간 (Storage): 최소 250 GB 이상의 여유 디스크 공간 (SSD 권장)
• OS: Debian 기반 (Ubuntu 권장)
• 안정적인 인터넷 연결 (설치 시에만 필요)

세 가지 가격대($150–$1,000 이상)별 상세 빌드 권장 사항은 하드웨어 가이드(Hardware Guide)를 참조하세요.

다시 말씀드리지만, Project N.O.M.A.D. 자체는 매우 가볍습니다. 사용자의 고유한 배포 환경에 필요한 사양을 결정하는 것은 N.O.M.A.D.와 함께 설치하기로 선택한 도구와 리소스들입니다.

기본적으로 N.O.M.A.D.의 설치 프로그램은 AI 어시스턴트(AI Assistant)가 설치될 때 호스트에 Ollama를 설정하려고 시도합니다. 하지만 AI 모델을 다른 호스트에서 실행하고 싶다면, AI 어시스턴트의 설정으로 이동하여 Ollama 또는 OpenAI 호환 API 서버(예: LM Studio)의 URL을 입력할 수 있습니다.

다른 호스트에서 Ollama를 사용하는 경우, 반드시 OLLAMA_HOST=0.0.0.0 옵션을 사용하여 서버를 시작해야 한다는 점에 유의하세요.

Ollama는 OpenAI API가 지원하지 않는 모델 다운로드와 같은 기능을 갖추고 있기 때문에 AI 어시스턴트를 사용하는 데 권장되는 방식입니다. 따라서 예를 들어 LM Studio를 사용하는 경우, 모델을 다운로드하려면 LM Studio를 사용해야 합니다.
다른 호스트에 Ollama/OpenAI 서버를 설정하는 책임은 사용자에게 있습니다.

Project N.O.M.A.D.에 대한 일반적인 질문에 대한 답변은 FAQ 페이지를 참조하세요.

Project N.O.M.A.D.는 오프라인 사용을 위해 설계되었습니다. 인터넷 연결은 초기 설치 시(종속성 다운로드용)와 사용자(User)가 나중에 추가 도구 및 리소스를 다운로드하기로 결정한 경우에만 필요합니다. 그 외의 경우, N.O.M.A.D.는 인터넷 연결을 요구하지 않으며 내장된 텔레메트리(Telemetry)가 전혀 없습니다.

인터넷 연결을 테스트하기 위해, N.O.M.A.D.는 Cloudflare의 유틸리티 엔드포인트인 https://1.1.1.1/cdn-cgi/trace로 요청을 보내 성공적인 응답이 오는지 확인합니다.

설계 단계부터 Project N.O.M.A.D.는 장애물 없이 개방적이고 사용 가능하도록 의도되었으며, 인증 (authentication) 과정을 포함하지 않습니다. 설치 후 장치를 로컬 네트워크 (local network)에 연결하기로 결정했다면 (예: 다른 장치가 리소스에 접근할 수 있도록 허용하는 경우), 포트 (ports)를 차단하거나 열어서 어떤 서비스가 노출될지 제어할 수 있습니다.

향후 인증 기능이 추가될까요? 그럴 수도 있습니다. 현재로서는 우선순위가 아니지만, 수요가 충분하다면 향후 릴리스에서 선택적인 인증 계층 (authentication layer)을 구축하는 것을 고려할 수 있습니다. 이는 여러 사용자가 동일한 인스턴스 (instance)에 접근해야 하지만 서로 다른 권한 수준 (permission levels)이 필요한 사용 사례 (예: 자녀 보호 기능이 포함된 가족용 사용, 교사/관리자 계정이 포함된 교실용 사용 등)를 지원하기 위함입니다. 이에 대한 제안 사항이 저희의 공개 로드맵 (public roadmap)에 있으니, 만약 이 기능을 보고 싶으시다면 여기서 추천(upvote)을 눌러주세요: https://roadmap.projectnomad.us/posts/1/user-authentication-please-build-in-user-auth-with-admin-user-roles

현재로서는 N.O.M.A.D. 인스턴스를 로컬 네트워크의 다른 장치에 노출할 계획이라면 네트워크 수준의 제어 (network-level controls)를 사용하여 액세스를 관리할 것을 권장합니다. N.O.M.A.D.는 인터넷에 직접 노출되도록 설계되지 않았으며, 본인이 수행하는 작업을 정확히 알고 적절한 보안 조치를 취했으며 관련 위험을 이해하고 있는 경우가 아니라면 인터넷에 직접 노출하는 것을 강력히 반대합니다.

기여 (Contributions)는 언제나 환영하며 감사하게 생각합니다! 프로젝트에 기여하는 방법에 대한 가이드라인은 CONTRIBUTING.md를 참조해 주세요.

웹사이트: www.projectnomad.us - 프로젝트에 대해 더 알아보기
Discord: 커뮤니티 참여 - 도움을 받고, 본인의 빌드를 공유하며, 다른 NOMAD 사용자들과 소통하세요
벤치마크 리더보드 (Benchmark Leaderboard): benchmark.projectnomad.us - 귀하의 하드웨어가 다른 NOMAD 빌드와 비교해 어느 정도 수준인지 확인하세요
문제 해결 가이드 (Troubleshooting Guide): TROUBLESHOOTING.md - 일반적인 문제에 대한 해결책을 찾으세요
FAQ: FAQ.md - 자주 묻는 질문에 대한 답변을 찾으세요
커뮤니티 애드온 (Community Add-Ons): admin/docs/community-add-ons.md - 커뮤니티에서 제작한 제3자 콘텐츠 팩

Project N.O.M.A.D.는 Apache License 2.0 라이선스 하에 배포됩니다.

설치가 완료되면, Command Center를 통해 수행할 수 없는 문제 해결(Troubleshooting)이나 유지보수(Maintenance)가 필요한 경우를 대비하여 Project N.O.M.A.D.는 몇 가지 헬퍼 스크립트(Helper scripts)를 제공합니다. 이 모든 스크립트는 Project N.O.M.A.D.의 설치 디렉토리인 /opt/project-nomad에서 찾을 수 있습니다.

sudo bash /opt/project-nomad/start_nomad.sh

sudo bash /opt/project-nomad/stop_nomad.sh

업데이트 스크립트 (Update Script) - Command Center 및 그 종속성(예: mysql)에 대한 최신 이미지(Images)를 가져오고 컨테이너(Containers)를 재생성하려고 시도합니다. 주의: 이 스크립트는 Command Center 컨테이너만 업데이트합니다. 설치 가능한 애플리케이션 컨테이너는 업데이트하지 않으며, 이는 Command Center UI를 통해 수행해야 합니다.

sudo bash /opt/project-nomad/update_nomad.sh

삭제 스크립트 (Uninstall Script) - 처음부터 다시 시작해야 하나요? 삭제 스크립트를 사용하면 편리합니다. 주의: 이 작업은 되돌릴 수 없습니다!

curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/uninstall_nomad.sh -o uninstall_nomad.sh && sudo bash uninstall_nomad.sh