Bỏ qua tới nội dung
Ông T.vn

Project NOMAD: máy chủ kiến thức offline, có AI cục bộ — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

Bài này là một góc nhìn khác về Crosstalk-Solutions/project-nomad — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Project NOMAD: máy chủ tri thức offline, có AI nội bộ — hướng dẫn cài đặt và dùng →

Project NOMAD: máy chủ kiến thức offline, có AI cục bộ — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Project NOMAD là một máy chủ kiến thức offline. Nó gom Wikipedia, sách, khoá học Khan Academy, bản đồ, ghi chú và trợ lý AI cục bộ vào một giao diện web chạy trên máy của bạn. Cài bằng một đoạn lệnh trên Ubuntu hoặc Debian, phần lõi khá nhẹ, chỉ phần AI mới đòi hỏi máy mạnh.

Project NOMAD là một máy chủ kiến thức và giáo dục theo hướng “offline trước”: bạn cài nó lên một máy của mình, rồi mở bằng trình duyệt để đọc Wikipedia, sách, học các khoá học, xem bản đồ và (nếu muốn) chat với AI chạy ngay trên máy đó. Sau khi cài xong, bạn không cần internet để dùng. Hiện có khoảng 43.000 sao và 4.400 fork trên GitHub, giấy phép Apache-2.0.

Vấn đề nó giải quyết khá đơn giản: khi mất mạng, mạng yếu, hoặc bạn không muốn dữ liệu của mình chạy lên dịch vụ đám mây, thì kho kiến thức quen thuộc cũng biến mất theo. NOMAD gom sẵn những thứ đó vào một chỗ, trên phần cứng bạn sở hữu. Nó hợp với người thích tự dựng hệ thống riêng, giáo viên hoặc gia đình muốn có thư viện học tập dùng chung, và lập trình viên muốn thử AI cục bộ có tìm kiếm trong tài liệu của mình.

Điểm đáng giá nhất là bạn không phải tự ghép từng công cụ. NOMAD là một giao diện quản lý (tác giả gọi là Command Center) điều phối các công cụ chạy trong Docker, lo luôn việc cài, cấu hình và cập nhật. Bạn xem video ngắn bên dưới để thấy nó trông thế nào, rồi quay lại đây làm theo từng bước.

Ứng dụng

Crosstalk-Solutions/project-nomad

Máy chủ kiến thức và giáo dục chạy offline: Wikipedia, sách, khoá học, bản đồ và AI cục bộ, truy cập qua trình duyệt trên phần cứng của bạn.

★ 43kTypeScriptApache-2.0
Xem repo trên GitHub
Video giới thiệu project-nomadXem trên YouTubeXem trên Facebook

I.Project NOMAD làm được gì

Theo README, NOMAD không tự viết lại mọi thứ mà gói các công cụ mã nguồn mở có sẵn vào một giao diện chung. Mỗi mảng có một công cụ riêng đứng sau:

  • Thư viện thông tin: Wikipedia offline, tài liệu y khoa, sách điện tử và nhiều nội dung khác, chạy bằng Kiwix. Lợi ích thực tế là bạn tra cứu được kể cả khi không có mạng.
  • Trợ lý AI có kho kiến thức: chat với mô hình chạy cục bộ bằng Ollama. Bạn cũng có thể dùng phần mềm tương thích OpenAI API như LM Studio hoặc llama.cpp. Có thể tải tài liệu lên và tìm kiếm theo ngữ nghĩa (RAG, nhờ Qdrant), nên AI trả lời dựa trên tài liệu của bạn.
  • Nền tảng học tập: các khoá học Khan Academy, có theo dõi tiến độ và hỗ trợ nhiều người dùng, nhờ Kolibri.
  • Bản đồ offline: tải bản đồ theo vùng để xem và tìm kiếm khi không có mạng, nhờ ProtoMaps.
  • Công cụ dữ liệu: mã hoá, giải mã, băm và phân tích dữ liệu bằng CyberChef.
  • Ghi chú: ghi chú cục bộ, hỗ trợ markdown, bằng FlatNotes.
  • Đo hiệu năng hệ thống: chấm điểm phần cứng của bạn và so với bảng xếp hạng cộng đồng.
  • Supply Depot: danh mục ứng dụng cài một cú nhấp (công cụ PDF, trình duyệt file, thư viện sách điện tử, trình quản lý mật khẩu…) và cho phép chạy cả container Docker tự chọn.
  • Cập nhật tự động: tuỳ chọn, bạn đặt lịch cho phần mềm lõi, ứng dụng đã cài và nội dung offline.
  • Trình hướng dẫn thiết lập: lần đầu dùng sẽ có các bộ nội dung được chọn sẵn để bạn không phải mò.

Ngoài ra, README nói NOMAD có sẵn công cụ chọn nội dung Wikipedia, trình quản lý thư viện ZIM và trình khám phá nội dung. README cũng khẳng định NOMAD không có telemetry nào được tích hợp sẵn.

II.Cần chuẩn bị gì

Theo README, bạn cần:

  • Hệ điều hành: hệ Debian. Khuyến nghị Ubuntu 26.04 LTS; Ubuntu 24.04 LTS và Debian 12 cũng được hỗ trợ. Cài đặt hoàn toàn bằng terminal, còn dùng thì qua trình duyệt, nên máy không cần giao diện desktop. Bạn có thể cài trên một máy chủ rồi truy cập từ máy khác.
  • Quyền quản trị: cần sudo/root để chạy script cài.
  • Internet: cần ổn định, nhưng chỉ trong lúc cài (và khi bạn tải thêm công cụ, nội dung sau này).
  • Cấu hình tối thiểu cho phần lõi: CPU lõi kép 2 GHz trở lên, RAM 4 GB (cả hệ thống không có AI chạy dưới 1 GB), ít nhất 5 GB ổ trống (nên chuẩn bị 10 GB cho thoải mái).
  • Nếu muốn dùng AI: thêm khoảng 25 GB dung lượng. Mô hình cần bộ nhớ xấp xỉ dung lượng tải về khi trả lời; bộ nhớ này lấy từ VRAM nếu có card đồ hoạ rời, không thì lấy từ RAM hệ thống. README gợi ý cấu hình tối ưu: Ryzen 7 hoặc Core i7 trở lên, RAM 32 GB, card NVIDIA RTX 3060 hoặc tương đương AMD trở lên, ổ trống ít nhất 250 GB (tốt nhất là SSD).
  • Người dùng Windows: README nói có hướng dẫn cài qua WSL2, nhưng đó là con đường do cộng đồng hỗ trợ. Xem trang hướng dẫn WSL2 trên website dự án.

Tài khoản hay API key: README không yêu cầu cho phần cài lõi.

NOMAD không có cơ chế đăng nhập. Ai vào được địa chỉ máy chủ là dùng được mọi thứ. Đừng đưa nó ra thẳng internet; nếu cho các thiết bị khác trong mạng nội bộ dùng, hãy tự chặn hoặc mở cổng ở cấp mạng.

III.Cài đặt từng bước

  1. Chuẩn bị máyDùng Ubuntu hoặc Debian, còn trống ít nhất 5-10 GB, có internet và quyền sudo
  2. Chạy lệnh càiDán một đoạn lệnh trong terminal để tải và chạy script cài
  3. Mở giao diệnVào địa chỉ http://localhost:8080 bằng trình duyệt
  4. Làm theo trình hướng dẫnChọn bộ nội dung và công cụ muốn cài
  5. Tuỳ chọn: cài AIThêm trợ lý AI nếu máy đủ mạnh

A.Chuẩn bị máy

Bạn cần một máy chạy hệ Debian (Ubuntu hay Debian 12). Mở terminal ngay trên máy đó, hoặc kết nối vào qua SSH nếu đó là máy chủ. Người mới hay vấp ở chỗ: lệnh cài phải chạy trong terminal của hệ Linux, không phải PowerShell của Windows. Nếu bạn dùng Windows, hãy đọc hướng dẫn WSL2 của dự án trước.

B.Chạy lệnh cài

Đây là lệnh trong README. Nó cập nhật danh sách gói, cài curl, tải script cài về thành file install_nomad.sh, rồi chạy file đó bằng quyền sudo:

Terminal
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 \
  -o install_nomad.sh && \
sudo bash install_nomad.sh

Bạn có thể dán nguyên cả khối vào terminal. Các dấu \ cuối dòng nghĩa là lệnh còn tiếp ở dòng sau; nếu gõ tay, hãy chép đủ. Hệ thống có thể hỏi mật khẩu sudo. Hãy để máy chạy đến khi script kết thúc, đừng tắt giữa chừng.

Sau khi cài, README cho biết các file quản lý nằm trong thư mục /opt/project-nomad.

C.Mở giao diện trên trình duyệt

README nói NOMAD đã được cài xong ở bước trên. Mở trình duyệt và vào http://localhost:8080 nếu bạn đang ngồi tại chính máy đó. Nếu truy cập từ máy khác trong mạng, dùng http://DEVICE_IP:8080, trong đó DEVICE_IP là địa chỉ IP của máy chủ NOMAD.

D.Làm theo trình hướng dẫn và chọn nội dung

Lần đầu vào, trình hướng dẫn thiết lập sẽ dẫn bạn chọn các bộ nội dung có sẵn. Mẹo cho người mới: đừng tải hết trong một lần. Nội dung offline mới là thứ chiếm ổ đĩa, nên hãy chọn vài mục cần nhất trước, xem dung lượng từng mục trong trang FAQ của dự án rồi thêm sau.

E.Cài thêm trợ lý AI (tuỳ chọn)

Khi bạn cài trợ lý AI, mặc định trình cài sẽ cố gắng thiết lập Ollama ngay trên máy chủ. Nếu muốn chạy mô hình ở một máy khác, vào phần cài đặt của trợ lý AI và nhập URL của máy chủ Ollama hoặc máy chủ tương thích OpenAI (ví dụ LM Studio). README lưu ý: với Ollama trên máy khác, phải khởi động nó với tuỳ chọn:

Terminal
OLLAMA_HOST=0.0.0.0

Nếu dùng LM Studio, bạn phải tải mô hình bằng chính LM Studio, vì chức năng tải mô hình chỉ có khi dùng Ollama. README nhấn mạnh bạn tự chịu trách nhiệm thiết lập máy chủ Ollama/OpenAI ở máy kia.

F.Cách cài nâng cao bằng Docker Compose

README còn có cách cài khác dành cho người rành Docker: chép mẫu Docker Compose của dự án vào file docker-compose.yml, thay các chỗ giữ chỗ bằng giá trị thật của bạn, rồi chạy:

Terminal
docker compose up -d

Lệnh này khởi động Command Center và các thành phần phụ thuộc. README khuyên chỉ nên dùng cách này nếu bạn đã quen Docker, vì phải tự cấu hình trước khi chạy.

IV.Kiểm tra đã chạy được chưa

Cách kiểm tra theo README rất đơn giản: mở trình duyệt vào http://localhost:8080 (hoặc http://DEVICE_IP:8080). Nếu giao diện NOMAD hiện ra và bạn vào được trình hướng dẫn thiết lập, nghĩa là cài thành công.

Nếu trang không mở, bạn có thể thử khởi động lại các container bằng script đi kèm:

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

Lệnh này khởi động tất cả container của dự án đã cài. Muốn dừng thì dùng:

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

Ngoài ra README có nhắc một số lệnh bảo trì khác, ví dụ cập nhật Command Center:

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

Script này chỉ cập nhật các container của Command Center và thành phần đi kèm (như mysql). Các ứng dụng cài thêm thì cập nhật qua giao diện Command Center.

V.Dùng vào việc thật

A.Thư viện tra cứu cho cả nhà hoặc văn phòng nhỏ

Bối cảnh: văn phòng của bạn ở chỗ mạng chập chờn, hoặc bạn muốn mọi người có kho tra cứu chung mà không phụ thuộc dịch vụ ngoài. Bạn cài NOMAD lên một máy mini luôn bật, chạy trình hướng dẫn và chọn bộ nội dung Wikipedia cùng tài liệu tham khảo. Sau đó mọi người trong mạng nội bộ mở http://DEVICE_IP:8080 trên điện thoại hay laptop để tra. Kết quả là một “Wikipedia nội bộ” không cần mạng ngoài.

Cài một lần khi có mạng, rồi kiến thức nằm trong máy của bạn, không ai tắt được.

Ông T

Nhớ lưu ý bảo mật ở trên: NOMAD không có đăng nhập, nên chỉ để trong mạng nội bộ.

B.Góc học tập cho con em hoặc lớp nhỏ

Bối cảnh: bạn là phụ huynh hoặc giáo viên ở nơi internet kém. Trong trình hướng dẫn, chọn nền tảng học tập để có các khoá học Khan Academy chạy qua Kolibri. Mỗi người học có thể có tài khoản riêng vì nền tảng hỗ trợ nhiều người dùng, và có theo dõi tiến độ. Kết quả là em học tự động trên máy tính bảng hay laptop, còn bạn xem được mình đã học đến đâu. Lưu ý README ghi rõ việc phân quyền kiểu phụ huynh hoặc giáo viên ở cấp toàn NOMAD hiện chưa có; đó mới là ý tưởng trên lộ trình của dự án.

C.Hỏi AI về tài liệu riêng của bạn

Bối cảnh: bạn là nhân viên văn phòng hay dev có một đống tài liệu nội bộ và không muốn đưa lên dịch vụ AI ngoài. Cài trợ lý AI, rồi tải tài liệu vào kho kiến thức. Phần tìm kiếm ngữ nghĩa (RAG qua Qdrant) giúp AI trả lời dựa trên chính file của bạn. Câu hỏi mẫu bạn có thể gõ vào khung chat:

text
Tóm tắt các điểm chính trong tài liệu quy trình vừa tải lên và liệt kê những việc tôi cần làm.

Kết quả là câu trả lời chạy hoàn toàn trên phần cứng của bạn. Chất lượng và tốc độ phụ thuộc vào mô hình và máy, nên máy yếu sẽ chậm.

D.Bản đồ và công cụ dữ liệu khi đi xa

Bối cảnh: bạn đi công tác ở vùng sóng yếu. Trước chuyến đi, tải bản đồ khu vực cần đến bằng tính năng bản đồ offline. Khi ở đó, bạn xem và tìm kiếm trên bản đồ không cần mạng. Nếu làm kỹ thuật, CyberChef tích hợp sẵn cũng giúp bạn mã hoá, giải mã hay băm dữ liệu nhanh ngay trong trình duyệt, không phải gửi dữ liệu đi đâu. Kết quả là một bộ công cụ gọn dùng được cả khi hoàn toàn mất mạng.

VI.Lỗi hay gặp và cách xử lý

A.Trang http://localhost:8080 không mở được

Thường do container chưa chạy, hoặc bạn đang truy cập từ máy khác nhưng vẫn gõ localhost. Từ máy khác, hãy dùng địa chỉ IP của máy chủ. Nếu vẫn không được, chạy lại sudo bash /opt/project-nomad/start_nomad.sh và kiểm tra tường lửa đã cho cổng 8080 chưa. Nếu bạn dùng cách cài bằng Docker Compose, hãy xem lại xem mình đã thay hết các chỗ giữ chỗ trong file chưa.

B.Lệnh cài báo lỗi quyền hoặc thiếu curl

Script cần quyền sudo. Hãy chạy đúng chuỗi lệnh trong README (có cài curl trước) và trên hệ Debian. Nếu bạn dùng hệ khác như Fedora hay Windows PowerShell, lệnh này sẽ không chạy; README chỉ hỗ trợ hệ Debian và đường cài qua WSL2 do cộng đồng hỗ trợ.

C.Hết dung lượng ổ đĩa

Phần lõi chỉ cần khoảng 5 GB, nhưng nội dung offline và AI chiếm rất nhiều (AI thêm cỡ 25 GB). Hãy chọn từng bộ nội dung, xem dung lượng trong FAQ và dùng ổ SSD lớn nếu có thể. Tránh tải mọi thứ ngay từ đầu.

D.AI trả lời rất chậm hoặc không chạy

Mô hình cần bộ nội dung bằng xấp xỉ dung lượng tải về để trả lời. Không có GPU rời, nó dùng RAM hệ thống nên dễ chậm hoặc đầy bộ nhớ. Hãy thử mô hình nhỏ hơn, hoặc chạy Ollama ở một máy khác mạnh hơn rồi nhập URL vào phần cài đặt trợ lý AI (nhớ khởi động Ollama với OLLAMA_HOST=0.0.0.0).

E.Ứng dụng báo “offline” dù bạn có mạng

NOMAD kiểm tra kết nối bằng một yêu cầu tới endpoint tiện ích của Cloudflare, và nếu không được sẽ thử các địa chỉ khác như GitHub API và API của dự án. Nếu mạng của bạn chặn các địa chỉ đó, bạn có thể đổi địa chỉ kiểm tra trong phần Settings → Advanced, hoặc đặt biến môi trường INTERNET_STATUS_TEST_URL (biến này được ưu tiên hơn giá trị trong giao diện).

VII.Có nên dùng không

Điểm mạnh. NOMAD gom nhiều công cụ offline hữu ích vào một giao diện, cài bằng một đoạn lệnh, dữ liệu nằm trên máy bạn. README khẳng định không có telemetry tích hợp. Phần lõi nhẹ, còn AI là tuỳ chọn. Repo còn được cập nhật trong vài tháng gần đây và có cộng đồng khá lớn.

Giới hạn. Chỉ hỗ trợ hệ Debian; Windows phải đi đường WSL2 do cộng đồng hỗ trợ. Không có xác thực người dùng, nên không phù hợp để mở ra internet hoặc dùng chung khi cần phân quyền chặt. Để AI chạy mượt cần máy mạnh, ưu tiên card đồ hoạ rời, và nội dung offline chiếm nhiều ổ cứng.

Khi nào chọn cách khác. Nếu bạn chỉ cần chat với AI nhanh trên máy cá nhân, một công cụ chạy mô hình đơn lẻ như Ollama hoặc LM Studio đơn giản hơn. Nếu bạn cần hệ thống nhiều người dùng, nhiều quyền, hãy chờ dự án bổ sung xác thực hoặc tự dựng lớp bảo vệ ở cấp mạng. Còn nếu bạn muốn một thư viện tri thức và học tập tự chủ, chạy trên phần cứng của mình, NOMAD là lựa chọn đáng thử.

4.2/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Project NOMAD có miễn phí không?

Repo dùng giấy phép Apache-2.0, nên bạn có thể dùng và sửa theo điều khoản của giấy phép này. Bạn cần tự có phần cứng để chạy. README không nói về chi phí nào khác cho phần cài lõi.

Có cần GPU không?

Phần lõi không cần GPU, chỉ cần khoảng 5 GB ổ đĩa và RAM dưới 1 GB cho cả hệ thống khi không có AI. Với trợ lý AI, README khuyến khích máy có GPU, ví dụ NVIDIA RTX 3060 hoặc tương đương AMD. Nếu không có GPU rời, mô hình sẽ dùng RAM hệ thống.

Chạy được trên Windows không?

Trình cài chính thức dành cho hệ Debian như Ubuntu hay Debian 12. Với Windows, README nói có hướng dẫn cài qua WSL2, nhưng đó là con đường do cộng đồng hỗ trợ, gồm cả cách dùng Docker gốc và Docker Desktop.

Dữ liệu của tôi có an toàn không?

README khẳng định NOMAD không có telemetry tích hợp và chạy trên phần cứng của bạn. Tuy nhiên nó không có xác thực người dùng, nên ai truy cập được địa chỉ máy chủ đều dùng được. README khuyên dùng kiểm soát ở cấp mạng và không đưa thẳng ra internet.

Cần internet lúc nào?

Chỉ cần lúc cài, và khi bạn quyết định tải thêm công cụ hoặc nội dung. Sau đó NOMAD dùng được offline. Ứng dụng có kiểm tra kết nối bằng một endpoint của Cloudflare, và bạn có thể đổi địa chỉ kiểm tra trong Settings → Advanced.

Có thể dùng AI chạy trên máy khác không?

Có. Trong phần cài đặt của trợ lý AI, bạn nhập URL của máy chủ Ollama hoặc máy chủ tương thích OpenAI như LM Studio. Với Ollama ở máy khác, phải khởi động bằng tuỳ chọn OLLAMA_HOST=0.0.0.0. Với LM Studio, bạn tự tải mô hình bằng LM Studio.

Làm sao cập nhật hoặc gỡ cài đặt?

Script update_nomad.sh trong /opt/project-nomad cập nhật Command Center và thành phần đi kèm; các ứng dụng cài thêm thì cập nhật qua giao diện. README cũng có script gỡ cài đặt, nhưng lưu ý thao tác này không thể hoàn tác.

Chuyển nhanh tới mục

  1. I.Project NOMAD làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị máy
    2. B.Chạy lệnh cài
    3. C.Mở giao diện trên trình duyệt
    4. D.Làm theo trình hướng dẫn và chọn nội dung
    5. E.Cài thêm trợ lý AI (tuỳ chọn)
    6. F.Cách cài nâng cao bằng Docker Compose
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Thư viện tra cứu cho cả nhà hoặc văn phòng nhỏ
    2. B.Góc học tập cho con em hoặc lớp nhỏ
    3. C.Hỏi AI về tài liệu riêng của bạn
    4. D.Bản đồ và công cụ dữ liệu khi đi xa
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Trang http://localhost:8080 không mở được
    2. B.Lệnh cài báo lỗi quyền hoặc thiếu curl
    3. C.Hết dung lượng ổ đĩa
    4. D.AI trả lời rất chậm hoặc không chạy
    5. E.Ứng dụng báo “offline” dù bạn có mạng
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.