Project NOMAD: máy chủ kiến thức và AI chạy offline — hướng dẫn cài đặt và dùng
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 →

Tóm tắt nhanh
Project NOMAD là một máy chủ kiến thức và giáo dục chạy offline, gom Wikipedia, sách, khoá học Khan Academy, bản đồ và trợ lý AI cục bộ vào một giao diện web. Bạn cài bằng một lệnh trên Ubuntu hoặc Debian rồi mở trình duyệt để dùng. Phần lõi nhẹ, nhưng muốn chạy AI mượt thì cần máy mạnh hơn.
Project NOMAD là một máy chủ kiến thức và giáo dục "offline-first": bạn cài một lần, tải nội dung về, rồi dùng Wikipedia, sách, khoá học, bản đồ và cả trợ lý AI ngay trên phần cứng của mình, không cần internet. Mọi thứ truy cập qua trình duyệt, nên bạn có thể để nó chạy như một chiếc máy chủ nhỏ trong nhà hoặc văn phòng.
Repo này hợp với ai? Người muốn có kho tri thức riêng phòng khi mất mạng, gia đình hoặc lớp học muốn có tài liệu học tập dùng chung, người làm việc ở nơi sóng yếu, hoặc lập trình viên thích tự dựng hệ thống AI chạy cục bộ. Điểm đáng giá nhất: NOMAD lo hết phần cài đặt, cấu hình và cập nhật các công cụ bên trong, bạn không phải tự ghép từng phần.
Hiện repo có khoảng 43.297 sao và 4.453 fork, giấy phép Apache-2.0, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó trông như thế nào, rồi quay lại làm theo từng bước.
Crosstalk-Solutions/project-nomad
Project NOMAD là máy chủ kiến thức offline: Wikipedia, sách, khoá học, bản đồ và AI chạy cục bộ trên máy của bạn, không cần internet sau khi cài.
I.Project NOMAD làm được gì
NOMAD thực chất là một bảng điều khiển (README gọi là Command Center) cùng một API. Nó điều phối nhiều công cụ chạy trong Docker, mỗi công cụ lo một việc.
- Trợ lý AI có kho tri thức riêng. Chat với AI chạy cục bộ nhờ Ollama, hoặc dùng phần mềm tương thích OpenAI API như LM Studio hay llama.cpp. Bạn tải tài liệu lên, AI tìm kiếm theo ngữ nghĩa trong đó (dùng Qdrant). Lợi ích: hỏi đáp trên tài liệu của chính bạn mà dữ liệu không rời khỏi máy.
- Thư viện thông tin. Wikipedia offline, tài liệu y khoa, sách điện tử và nhiều thứ khác nhờ Kiwix. Mất mạng vẫn tra cứu được.
- Nền tảng học tập. Khoá học Khan Academy có theo dõi tiến độ, hỗ trợ nhiều người dùng, nhờ Kolibri.
- Bản đồ offline. Tải bản đồ theo khu vực để xem và tìm kiếm khi không có mạng (ProtoMaps).
- Công cụ dữ liệu. CyberChef để mã hoá, giải mã, băm và phân tích dữ liệu.
- Ghi chú. FlatNotes, ghi chú cục bộ, hỗ trợ markdown.
- Đo hiệu năng máy. Chấm điểm phần cứng 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 chạm (công cụ PDF, trình duyệt file, thư viện e-book, trình quản lý mật khẩu…), và cho phép chạy thêm container Docker của riêng bạn.
- Tự động cập nhật. Tuỳ chọn, bạn bật mới chạy, theo lịch bạn đặt, cho phần mềm lõi, ứng dụng và nội dung offline.
- Trình hướng dẫn thiết lập. Lần đầu vào sẽ có các bộ nội dung được chọn sẵn để bạn chọn theo.
Ngoài ra còn có công cụ chọn nội dung Wikipedia, quản lý thư viện ZIM và khám phá nội dung.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Hệ điều hành: nền Debian. Khuyến nghị Ubuntu 26.04 LTS; Ubuntu 24.04 LTS và Debian 12 cũng được hỗ trợ.
- Quyền: sudo/root, vì script cài đặt cần quyền này.
- Terminal: cài đặt hoàn toàn bằng dòng lệnh. Không cần giao diện desktop nếu bạn dựng nó như một máy chủ rồi vào từ máy khác.
- Internet: cần ổn định trong lúc cài. Sau đó chỉ cần khi bạn tải thêm công cụ hoặc nội dung.
- Cấu hình tối thiểu (chỉ 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), ổ đĩa trống ít nhất 5 GB (nên chuẩn bị 10 GB cho thoải mái).
- Nếu dùng AI: cài thêm AI Assistant đưa dung lượng lên khoảng 25 GB, vì Ollama và mô hình đều lớn. Mô hình cần bộ nhớ xấp xỉ dung lượng tải về khi trả lời: lấy từ VRAM nếu có card đồ hoạ rời, không thì lấy từ RAM.
- Cấu hình khuyến nghị cho AI: Ryzen 7 hoặc Core i7 trở lên, RAM 32 GB, card NVIDIA RTX 3060 hoặc AMD tương đương trở lên, ổ trống ít nhất 250 GB (nên là SSD).
- Người dùng Windows: README có hướng dẫn cài qua WSL2 trên website dự án. Đây là đường do cộng đồng hỗ trợ.
README không nhắc tài khoản hay API key nào cho phần lõi.
Nội dung offline mới là thứ ngốn ổ đĩa. Wikipedia, sách, bản đồ, khoá học đều nặng. Hãy xem mục dung lượng từng loại trong trang FAQ của dự án trước khi bấm tải, kẻo đầy ổ giữa chừng.
III.Cài đặt từng bước
- Chuẩn bị máyDùng Ubuntu/Debian, có sudo và internet
- Chạy lệnh càiDán một khối lệnh vào terminal
- Mở giao diệnVào http://localhost:8080 bằng trình duyệt
- Thiết lập lần đầuChọn nội dung và công cụ cần dùng
A.Chuẩn bị máy
Mở terminal trên máy Ubuntu hoặc Debian của bạn (nếu là máy chủ không có màn hình thì kết nối SSH vào). Kiểm tra máy có internet và tài khoản của bạn dùng được sudo. Nếu bạn đang dùng Windows, hãy xem hướng dẫn WSL2 trên website dự án thay vì chạy lệnh dưới đây trực tiếp.
B.Chạy lệnh cài
Đây là khối lệnh nguyên văn trong README. Nó cập nhật danh sách gói, cài curl, tải script cài đặt về rồi chạy script bằng quyền 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 \
-o install_nomad.sh && \
sudo bash install_nomad.shChỗ người mới hay vấp: dán cả khối một lần, đừng bỏ dấu \ cuối dòng. Hệ thống sẽ hỏi mật khẩu sudo. Chờ đến khi script chạy xong, quá trình tải có thể mất một lúc tuỳ đường truyền.
C.Mở giao diện
Cài xong, mở trình duyệt và vào:
http://localhost:8080Nếu bạn truy cập từ một máy khác trong mạng, thay localhost bằng địa chỉ IP của máy đã cài, dạng http://DEVICE_IP:8080.
D.Thiết lập lần đầu
Lần đầu vào, trình hướng dẫn thiết lập sẽ dẫn bạn qua các bước cấu hình, kèm các bộ nội dung được chọn sẵn. Hãy chọn vừa đủ dung lượng ổ đĩa của bạn. Bạn luôn có thể thêm nội dung sau.
E.Cách cài nâng cao (Docker Compose)
Nếu bạn quen Docker, README cho phép dùng file mẫu install/management_compose.yaml trong repo. Bạn chép nội dung vào file docker-compose.yml, thay các chỗ giữ chỗ bằng giá trị thật của mình, rồi chạy:
docker compose up -dREADME khuyên cách này chỉ dành cho người dùng nâng cao, vì phải tự cấu hình trước khi chạy.
IV.Kiểm tra đã chạy được chưa
Theo README, dấu hiệu thành công rất đơn giản: mở http://localhost:8080 (hoặc http://DEVICE_IP:8080) và thấy giao diện Command Center của NOMAD. Từ đó bạn vào được trình hướng dẫn thiết lập và các công cụ bên trong.
Nếu trang không mở, thử khởi động lại các container bằng script có sẵn:
sudo bash /opt/project-nomad/start_nomad.shCác script hỗ trợ đều nằm trong thư mục cài đặt /opt/project-nomad. Script dừng là stop_nomad.sh, cập nhật Command Center là update_nomad.sh:
sudo bash /opt/project-nomad/stop_nomad.sh
sudo bash /opt/project-nomad/update_nomad.shLưu ý: update_nomad.sh chỉ cập nhật các container của Command Center và phần phụ thuộc như mysql. Các ứng dụng cài thêm thì cập nhật trong giao diện Command Center.
V.Dùng vào việc thật
A.Chủ tiệm ở vùng sóng yếu muốn có kho tra cứu dùng chung
Bạn kinh doanh ở nơi mạng chập chờn. Hãy cài NOMAD lên một máy cũ đặt tại cửa hàng, trong trình hướng dẫn chọn bộ Wikipedia và sách tham khảo, rồi tải về lúc có mạng tốt. Sau đó nhân viên mở trình duyệt, vào http://DEVICE_IP:8080 từ máy của họ để tra cứu. Kết quả: cả cửa hàng có một thư viện chung, mạng rớt vẫn dùng được.
Cài một lần lúc 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
B.Nhân viên văn phòng hỏi AI trên tài liệu nội bộ
Bạn có vài file quy trình, hợp đồng mẫu hoặc tài liệu hướng dẫn không muốn đưa lên dịch vụ đám mây. Cài AI Assistant, tải tài liệu lên phần chat, rồi hỏi bằng câu tự nhiên, ví dụ:
Tóm tắt các bước phê duyệt chi phí trong tài liệu tôi vừa tải lên, mỗi bước một dòng.AI tìm trong tài liệu bằng tìm kiếm ngữ nghĩa và trả lời dựa trên đó. Dữ liệu ở lại trên máy của bạn. Lưu ý máy cần đủ RAM hoặc VRAM như phần chuẩn bị ở trên, nếu không câu trả lời sẽ chậm.
C.Giáo viên hoặc phụ huynh dựng góc học tập
Bạn muốn con hoặc học sinh học bài khi không có mạng. Chọn nội dung giáo dục trong trình hướng dẫn để có khoá học Khan Academy qua Kolibri. Kolibri hỗ trợ nhiều người dùng và theo dõi tiến độ, nên mỗi em có thể học theo tiến độ riêng. Kết quả: một máy chủ nhỏ phục vụ cả lớp học qua trình duyệt.
D.Lập trình viên tự dựng AI trên máy riêng
Nếu máy chạy NOMAD yếu nhưng bạn có một máy khác mạnh hơn, bạn có thể chạy mô hình AI ở máy kia. Trong phần cài đặt của AI Assistant, nhập URL của máy chủ Ollama hoặc máy chủ tương thích OpenAI (như LM Studio). Nếu dùng Ollama ở máy khác, README yêu cầu khởi động máy chủ Ollama với tuỳ chọn:
OLLAMA_HOST=0.0.0.0Với LM Studio, bạn phải tải mô hình bằng chính LM Studio, vì API kiểu OpenAI không hỗ trợ tải mô hình như Ollama. Phần thiết lập máy chủ AI bên kia do bạn tự chịu trách nhiệm.
VI.Lỗi hay gặp và cách xử lý
A.Script cài đặt báo thiếu quyền
README yêu cầu sudo/root. Hãy chạy đúng lệnh có sudo như hướng dẫn, và dùng tài khoản có quyền quản trị. Đừng chép riêng từng dòng rồi bỏ sudo.
B.Cài không xong vì không có mạng hoặc mạng chập chờn
Lúc cài, máy cần internet ổn định để tải thành phần. Kiểm tra kết nối rồi chạy lại khối lệnh cài. Nếu mạng của bạn chặn địa chỉ 1.1.1.1, README cho biết NOMAD sẽ tự thử các điểm kiểm tra khác (GitHub API và API của dự án). Bạn cũng 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.
C.Không mở được trang 8080
Thử khởi động lại bằng sudo bash /opt/project-nomad/start_nomad.sh. Nếu vào từ máy khác, nhớ dùng IP của máy chủ thay cho localhost, và kiểm tra tường lửa hoặc mạng có chặn cổng 8080 không.
D.AI trả lời rất chậm hoặc không chạy nổi
Đây là lỗi dễ gặp nhất. Mô hình cần bộ nhớ gần bằng dung lượng tải về: nếu không có card đồ hoạ rời thì nó dùng RAM hệ thống. Máy ở mức tối thiểu chỉ đủ chạy phần lõi. Hãy nâng RAM hoặc thêm GPU, hoặc chạy AI ở một máy khác như đã nói ở trên.
E.Hết dung lượng ổ đĩa
Nội dung offline lớn nhanh. Kiểm tra dung lượng trước khi tải, ưu tiên bộ nội dung thật sự cần. Nếu cần làm lại từ đầu, README có script gỡ cài đặt, nhưng lệnh này không hoàn tác được nên hãy sao lưu dữ liệu quan trọng trước:
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.shVII.Có nên dùng không
Điểm mạnh. Cài đặt chỉ một khối lệnh. Gom nhiều công cụ hữu ích (Wikipedia, Khan Academy, bản đồ, AI, ghi chú) vào một giao diện web. Phần lõi nhẹ, README nói không có telemetry tích hợp, và dữ liệu nằm trên máy của bạn. Giấy phép Apache-2.0.
Giới hạn. Chỉ hỗ trợ hệ điều hành nền Debian; Windows đi đường WSL2 do cộng đồng hỗ trợ. Muốn AI chạy tốt thì cần phần cứng mạnh, khác hẳn mức tối thiểu. Quan trọng nhất là về bảo mật: NOMAD không có đăng nhập. README nói rõ nó không được thiết kế để phơi trực tiếp ra internet, và khuyên dùng kiểm soát ở tầng mạng (chặn hoặc mở cổng) nếu bạn cho thiết bị khác trong mạng truy cập.
Đừng mở NOMAD ra internet công cộng. Máy chủ không có xác thực, ai vào được cổng 8080 là dùng được mọi thứ bên trong. Chỉ cho phép các thiết bị trong mạng nội bộ đáng tin.
Khi nào nên chọn cách khác. Nếu bạn cần phân quyền theo người dùng (ví dụ tài khoản giáo viên và học sinh khác nhau), hiện NOMAD chưa có. Tác giả nói chỉ cân nhắc thêm nếu có đủ nhu cầu. Nếu bạn chỉ cần một chatbot AI đơn giản trên máy cá nhân, một phần mềm như LM Studio có thể đã đủ. NOMAD đáng thử khi bạn muốn cả bộ: tri thức, học tập, bản đồ và AI trong một nơi, chạy trên phần cứng của mình.
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, bạn tải và dùng được. README không nhắc phí bản quyền nào. Chi phí thực tế chủ yếu là phần cứng và dung lượng ổ đĩa cho nội dung offline.
Có cần GPU không?
Phần lõi không cần: README nói cả hệ thống không có AI chạy dưới 1 GB RAM. Muốn chạy AI tốt, tác giả khuyến nghị card như NVIDIA RTX 3060 trở lên. 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?
Script cài đặt dành cho hệ điều hành nền Debian như Ubuntu hoặc Debian. Người dùng Windows có hướng dẫn cài qua WSL2 trên website dự án, và README nói đây là đường do cộng đồng hỗ trợ.
Dữ liệu của tôi có an toàn không?
README nói NOMAD có ZERO telemetry tích hợp và chỉ cần internet khi cài hoặc khi bạn tải thêm nội dung. Tuy nhiên NOMAD không có đăng nhập, nên không nên mở ra internet. Nếu cho thiết bị khác trong mạng truy cập, hãy dùng kiểm soát cổng ở tầng mạng.
Cần bao nhiêu dung lượng ổ đĩa?
Phần lõi cần khoảng 5 GB trống, nên chuẩn bị 10 GB. Thêm AI Assistant thì lên khoảng 25 GB. Cấu hình khuyến nghị cho AI là ít nhất 250 GB, tốt nhất là SSD. Dung lượng từng loại nội dung xem ở trang FAQ của dự án.
Dùng AI có cần tài khoản hay API key không?
README mô tả AI chạy cục bộ qua Ollama, không nhắc API key. Bạn cũng có thể trỏ tới máy chủ Ollama hoặc máy chủ tương thích OpenAI như LM Studio ở máy khác trong phần cài đặt của AI Assistant.
Cập nhật NOMAD thế nào?
Có script update_nomad.sh trong thư mục /opt/project-nomad để cập nhật Command Center. Ứng dụng cài thêm thì cập nhật trong giao diện. Ngoài ra có tuỳ chọn tự động cập nhật theo lịch bạn đặt, và bản chính (major) luôn phải cập nhật thủ công.


