project-nomad
Project NOMAD는 인터넷 연결 없이 개인이 소유한 하드웨어에서 직접 구동되는 오프라인 우선(offline-first) 지식 및 교육 서버입니다. 위키백과, 수천 권의 도서, 강의, 지도, 그리고 선택 사항인 로컬 AI를 모두 제공합니다.
파일 탐색기
최종 버전 다운로드 (.zip)- bug_report.yml
- config.yml
- feature_request.yml
- finalize-release-notes.sh
- build-admin-on-pr.yml
- build-disk-collector.yml
- build-primary-image.yml
- build-sidecar-updater.yml
- release.yml
- validate-collection-urls.yml
- dependabot.yaml
- benchmark_controller.ts
- chats_controller.ts
- collection_updates_controller.ts
- conditions_controller.ts
- creator_packs_controller.ts
- docs_controller.ts
- downloads_controller.ts
- drug_reference_controller.ts
- easy_setup_controller.ts
- home_controller.ts
- maps_controller.ts
- nomad_md_controller.ts
- ollama_controller.ts
- openapi_controller.ts
- rag_controller.ts
- settings_controller.ts
- supply_depot_controller.ts
- system_controller.ts
- zim_controller.ts
- conditions.ts
- home_remedies.ts
- natural_remedies.ts
- handler.ts
- internal_server_error_exception.ts
- app_auto_update_job.ts
- auto_update_job.ts
- check_service_updates_job.ts
- check_update_job.ts
- content_auto_update_job.ts
- download_drug_data_job.ts
- download_model_job.ts
- embed_file_job.ts
- ingest_drug_data_job.ts
- run_benchmark_job.ts
- run_download_job.ts
- run_extract_pmtiles_job.ts
- compression_middleware.ts
- container_bindings_middleware.ts
- force_json_response_middleware.ts
- maps_static_middleware.ts
- benchmark_result.ts
- benchmark_setting.ts
- chat_message.ts
- chat_session.ts
- collection_manifest.ts
- custom_library_source.ts
- drug_label.ts
- installed_resource.ts
- kb_ingest_state.ts
- kb_ratio_registry.ts
- kv_store.ts
- map_marker.ts
- service.ts
- wikipedia_selection.ts
- app_auto_update_service.ts
- auto_update_service.ts
- benchmark_service.ts
- benchmark_telemetry.ts
- chat_service.ts
- collection_manifest_service.ts
- collection_update_service.ts
- condition_service.ts
- container_registry_service.ts
- content_auto_update_service.ts
- countries_service.ts
- creator_pack_service.ts
- custom_app_guard.ts
- docker_service.ts
- docs_service.ts
- download_service.ts
- drug_reference_service.ts
- kiwix_catalog_service.ts
- kiwix_library_service.ts
- map_service.ts
- nomad_md_service.ts
- ollama_service.ts
- queue_service.ts
- rag_service.ts
- system_service.ts
- system_update_service.ts
- zim_extraction_service.ts
- zim_service.ts
- affirmative_remedies.ts
- amd_hsa_override.ts
- content_auto_update_backoff.ts
- content_reindex_decision.ts
- downloads.ts
- fs.ts
- hosted_content.ts
- hosted_content_auth.ts
- image_disk_preflight.ts
- kb_ingest_decision.ts
- kb_job_health.ts
- kb_ratio_lookup.ts
- kb_warning_decision.ts
- misc.ts
- platform_metadata.ts
- superseded_resource.ts
- update_window.ts
- version.ts
- zim_download_resolution.ts
- zim_filename.ts
- zim_html.ts
- chat.ts
- common.ts
- benchmark.ts
- chat.ts
- common.ts
- conditions.ts
- curated_collections.ts
- download.ts
- drug_reference.ts
- nomad_md.ts
- ollama.ts
- rag.ts
- settings.ts
- system.ts
- zim.ts
- console.ts
- server.ts
- test.ts
- dry_run.ts
- dry_run.ts
- results.ts
- run.ts
- submit.ts
- dry_run.ts
- work.ts
- app.ts
- bodyparser.ts
- cors.ts
- database.ts
- hash.ts
- inertia.ts
- logger.ts
- queue.ts
- session.ts
- shield.ts
- static.ts
- transmit.ts
- vite.ts
- broadcast.ts
- kb_collections.ts
- kiwix.ts
- kv_store.ts
- map_regions.ts
- misc.ts
- ollama.ts
- service_names.ts
- supply_depot_docs.ts
- zim_extraction.ts
- 1751086751801_create_services_table.ts
- 1763499145832_update_services_table.ts
- 1764912210741_create_curated_collections_table.ts
- 1764912270123_create_curated_collection_resources_table.ts
- 1768170944482_update_services_add_installation_statuses_table.ts
- 1768453747522_update_services_add_icon.ts
- 1769097600001_create_benchmark_results_table.ts
- 1769097600002_create_benchmark_settings_table.ts
- 1769300000001_add_powered_by_and_display_order_to_services.ts
- 1769300000002_update_services_friendly_names.ts
- 1769324448000_add_builder_tag_to_benchmark_results.ts
- 1769400000001_create_installed_tiers_table.ts
- 1769400000002_create_kv_store_table.ts
- 1769500000001_create_wikipedia_selection_table.ts
- 1769646771604_create_create_chat_sessions_table.ts
- 1769646798266_create_create_chat_messages_table.ts
- 1769700000001_create_zim_file_metadata_table.ts
- 1770269324176_add_unique_constraint_to_curated_collection_resources_table.ts
- 1770273423670_drop_installed_tiers_table.ts
- 1770849108030_create_create_collection_manifests_table.ts
- 1770849119787_create_create_installed_resources_table.ts
- 1770850092871_create_drop_legacy_curated_tables_table.ts
- 1771000000001_add_update_fields_to_services.ts
- 1771000000002_pin_latest_service_images.ts
- 1771100000001_migrate_kiwix_to_library_mode.ts
- 1771200000001_create_map_markers_table.ts
- 1772000000001_add_supply_depot_fields_to_services.ts
- 1772000000002_add_user_modified_to_services.ts
- 1772000000003_add_app_auto_update_fields_to_services.ts
- 1775100000001_create_custom_library_sources_table.ts
- 1776000000001_create_kb_ingest_state_table.ts
- 1776100000001_create_kb_ratio_registry_table.ts
- 1776200000001_add_content_auto_update_fields_to_installed_resources.ts
- 1776200000001_add_custom_url_to_services.ts
- 1776300000001_deprecate_legacy_kolibri.ts
- 1776400000001_add_benchmark_harness_metadata.ts
- 1776400000001_add_collection_to_kb_ingest_state.ts
- 1776400000001_sunset_meshtastic_daemon.ts
- 1776400000002_add_benchmark_score_v2.ts
- 1776400000003_add_benchmark_platform_metadata.ts
- 1778600000004_create_drug_labels_table.ts
- 1778600000006_add_indications_fulltext_index.ts
- 1778700000006_add_ingested_at_default_drug_labels.ts
- service_seeder.ts
- about.md
- api-reference.md
- community-add-ons.md
- drug-reference.md
- faq.md
- getting-started.md
- home.md
- release-notes.md
- supply-depot-apps.md
- updates.md
- use-cases.md
- app.tsx
- BenchmarkRunView.tsx
- CoreGrid.tsx
- LiveReadout.tsx
- ResultsSoFar.tsx
- ScoreReveal.tsx
- Sparkline.tsx
- StageRail.tsx
- ChatAssistantAvatar.tsx
- ChatButton.tsx
- ChatInterface.tsx
- ChatMessageBubble.tsx
- ChatModal.tsx
- ChatSidebar.tsx
- CollectionCombobox.tsx
- CollectionsManager.tsx
- index.tsx
- KbPolicyPromptBanner.tsx
- KnowledgeBaseModal.tsx
- NomadMdModal.tsx
- RemedySafetyNote.tsx
- SafetyBanner.tsx
- DrugDisclaimerModal.tsx
- DrugResultRow.tsx
- IngestStatus.tsx
- IngredientGroup.tsx
- InteractionColumn.tsx
- LabelBlocks.tsx
- index.css
- index.tsx
- Input.tsx
- Select.tsx
- Switch.tsx
- BackToHomeHeader.tsx
- CoordinateOverlay.tsx
- MapComponent.tsx
- MarkerPanel.tsx
- MarkerPin.tsx
- ScaleUnitToggle.tsx
- Heading.tsx
- Image.tsx
- List.tsx
- ListItem.tsx
- Table.tsx
- CircularGauge.tsx
- InfoCard.tsx
- StatusCard.tsx
- AppAutoUpdateSection.tsx
- ContentAutoUpdateSection.tsx
- ContentUpdatesSection.tsx
- CoreAutoUpdateSection.tsx
- index.tsx
- ActiveDownloads.tsx
- ActiveEmbedJobs.tsx
- ActiveModelDownloads.tsx
- Alert.tsx
- AppUrlModal.tsx
- BouncingDots.tsx
- BouncingLogo.tsx
- BuilderTagSelector.tsx
- CategoryCard.tsx
- CountryPickerModal.tsx
- CreatorPackCard.tsx
- CreatorPacksSection.tsx
- CuratedCollectionCard.tsx
- CustomAppModal.tsx
- DebugInfoModal.tsx
- DownloadURLModal.tsx
- DynamicIcon.tsx
- Footer.tsx
- HorizontalBarChart.tsx
- InfoTooltip.tsx
- InstallActivityFeed.tsx
- KbGuardrailModal.tsx
- LoadingSpinner.tsx
- MarkdocRenderer.tsx
- MarkdownEditor.tsx
- ProgressBar.tsx
- ServiceLogsModal.tsx
- ServiceStatsModal.tsx
- StorageProjectionBar.tsx
- StyledButton.tsx
- StyledModal.tsx
- StyledSectionHeader.tsx
- StyledSidebar.tsx
- StyledTable.tsx
- ThemeToggle.tsx
- TierSelectionModal.tsx
- UpdateServiceModal.tsx
- WhatsNewBanner.tsx
- WikipediaSelector.tsx
- ModalContext.ts
- NotificationContext.ts
- app.css
- useAppAutoUpdateStatus.ts
- useAutoUpdateStatus.ts
- useBenchmarkRerunBanner.ts
- useBenchmarkRun.ts
- useContentAutoUpdateStatus.ts
- useCreatorPacks.ts
- useDebounce.ts
- useDiskDisplayData.ts
- useDownloads.ts
- useEmbedJobs.ts
- useErrorNotification.ts
- useInternetStatus.ts
- useMapMarkers.ts
- useMapRegionFiles.ts
- useOllamaModelDownloads.ts
- useServiceInstallationActivity.ts
- useServiceInstalledStatus.tsx
- useSystemInfo.ts
- useSystemSetting.ts
- useTheme.ts
- useUpdateAvailable.ts
- AppLayout.tsx
- DocsLayout.tsx
- MapsLayout.tsx
- SettingsLayout.tsx
- api.ts
- benchmarkScore.ts
- builderTagWords.ts
- classNames.ts
- collections.ts
- global_map_banner.ts
- icons.ts
- kb_file_grouping.ts
- kb_guardrail.ts
- kb_job_health_display.ts
- navigation.ts
- util.ts
- show.tsx
- show.tsx
- index.tsx
- interactions.tsx
- show.tsx
- complete.tsx
- index.tsx
- not_found.tsx
- server_error.tsx
- index.tsx
- remote-explorer.tsx
- advanced.tsx
- apps.tsx
- benchmark.tsx
- creator-packs.tsx
- legal.tsx
- maps.tsx
- models.tsx
- support.tsx
- system.tsx
- update.tsx
- about.tsx
- chat.tsx
- home.tsx
- maps.tsx
- supply-depot.tsx
- ModalProvider.tsx
- NotificationProvider.tsx
- ThemeProvider.tsx
- tsconfig.json
- gpu_passthrough_remediation_provider.ts
- kiwix_migration_provider.ts
- map_static_provider.ts
- qdrant_restart_policy_provider.ts
- version_check_provider.ts
- crosstalk-solutions.webp
- modern-rogue.webp
- project-nomad.webp
- ai-chat.webp
- benchmark.webp
- content-explorer.webp
- dashboard.webp
- easy-setup-step1.webp
- easy-setup-tiers.webp
- knowledge-base.webp
- maps.webp
- favicon-16x16.png
- favicon-180x180.png
- favicon-192x192.png
- favicon-32x32.png
- favicon-512x512 - Copy.png
- favicon-512x512.png
- powered_by_crosstalk.svg
- powered_by_crosstalk.webp
- project_nomad_logo.webp
- rogue-support-banner.webp
- ne_50m_admin_0_countries.geojson
- inertia_layout.edge
- audit_catalog_ports.py
- generate_curated_data.ts
- documented.ts
- generator.ts
- env.ts
- kernel.ts
- routes.ts
- openapi.spec.ts
- conditions.standalone.ts
- curated_data_sync.standalone.ts
- drug_ingest_status.standalone.ts
- drug_interactions.standalone.ts
- drug_tier_rework.standalone.ts
- natural_remedies.standalone.ts
- amd_hsa_override.spec.ts
- app_auto_update.spec.ts
- cloud_metadata_url.spec.ts
- content_auto_update.spec.ts
- content_auto_update_backoff.spec.ts
- content_reindex_decision.spec.ts
- curated_resource_schema.spec.ts
- custom_app_guard.spec.ts
- drug_ingest_status.spec.ts
- drug_interactions.spec.ts
- drug_labels.spec.ts
- global_map_banner.spec.ts
- kb_file_grouping.spec.ts
- kb_guardrail.spec.ts
- kb_ingest_decision.spec.ts
- kb_job_health.spec.ts
- kb_ratio_lookup.spec.ts
- kb_warning_decision.spec.ts
- platform_metadata.spec.ts
- private_url.spec.ts
- superseded_resource.spec.ts
- zim_download_resolution.spec.ts
- zim_filename.spec.ts
- zim_html.spec.ts
- bootstrap.ts
- benchmark.ts
- chat.ts
- collections.ts
- conditions.ts
- docker.ts
- downloads.ts
- drug_reference.ts
- files.ts
- kb_ingest_state.ts
- kv_store.ts
- maps.ts
- ollama.ts
- rag.ts
- services.ts
- system.ts
- util.ts
- zim.ts
- compare_ids.ts
- conditions.ts
- docs.ts
- drug_interactions.ts
- drug_labels.ts
- files.ts
- zim.ts
- inertia_layout.edge
- .editorconfig
- .env.example
- ace.js
- adonisrc.ts
- eslint.config.js
- package-lock.json
- package.json
- tailwind.config.ts
- tsconfig.json
- vite.config.ts
- CATEGORIES-TODO.md
- conditions.json
- creator-pack-license.md
- creator-packs.json
- home_remedies.json
- kiwix-categories.json
- maps.json
- natural_remedies.json
- wikipedia.json
- metadata.db
- README.md
- collect-disk-info.sh
- Dockerfile
- Dockerfile
- update-watcher.sh
- collect_disk_info.sh
- entrypoint.sh
- install_nomad.sh
- management_compose.yaml
- migrate-disk-collector.md
- migrate-disk-collector.sh
- run_updater_fixes.sh
- start_nomad.sh
- stop_nomad.sh
- uninstall_nomad.sh
- update_nomad.sh
- wikipedia_en_100_mini_2025-06.zim
- wikipedia_en_100_mini_2026-01.zim
- .dockerignore
- .gitignore
- .releaserc.json
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- Dockerfile
- FAQ.md
- LICENSE
- package-lock.json
- package.json
- README.md
# 설치 가이드
1. 코드 내려받기
git clone https://github.com/Crosstalk-Solutions/project-nomad
깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.
cd project-nomad
방금 내려받은 프로젝트 폴더 안으로 이동합니다.
2. 공식 설치 스크립트
쉬움 추천사전 준비물
- APT (Debian/Ubuntu 계열) Debian/Ubuntu 계열 리눅스에 기본 내장된 패키지 매니저입니다.
sudo apt-get install -y curl && \
APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).
설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
3. Docker
쉬움사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker build -t project-nomad .
Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.
docker run -p 8080:80 project-nomad
빌드된 이미지를 실제 컨테이너로 실행합니다.
터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.
4. Node.js
쉬움사전 준비물
cd admin
이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.
npm install
package.json에 명시된 라이브러리들을 내려받아 설치합니다.
npm start
개발/실행 서버를 켭니다.
명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.
// repository documentation
Was this content helpful?
(0 ratings)