Hướng dẫn 12: Thiết lập Nix & NixOS

Chào mừng bạn quay trở lại với chuỗi bài hướng dẫn về Hermes Agent! Trong bài này, chúng ta sẽ cùng tìm hiểu cách cài đặt Hermes Agent trên hệ thống Nix và NixOS. Nhưng có một điều cần lưu ý — tài liệu chính thức đã thay đổi, và Nix không còn là một đường dẫn cài đặt được hỗ trợ một cách tường minh nữa. Đừng lo lắng! Bạn vẫn còn nhiều lựa chọn, và chúng ta sẽ đề cập đến mọi thứ bạn cần biết.

Điều gì đã thay đổi?

Đội ngũ Hermes đã đơn giản hóa quá trình cài đặt một cách đáng kể. Thay vì duy trì nhiều đường dẫn cài đặt khác nhau, họ hiện khuyến nghị trình cài đặt phổ quát cho tất cả mọi người — bao gồm cả người dùng Nix. Hỗ trợ Nix hiện chỉ mang tính “cố gắng hết sức,” nghĩa là nó có thể hoạt động, nhưng không được kiểm tra hoặc đảm bảo chính thức.

Đường dẫn được khuyến nghị: Trình cài đặt phổ quát

Đối với hầu hết người dùng, cách dễ nhất để chạy Hermes Agent là sử dụng trình cài đặt một dòng lệnh. Nó hoạt động trên Linux, macOS, WSL2, và cả Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Trên Windows gốc, hãy sử dụng PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Trình cài đặt sẽ tự động xử lý mọi thứ — Python, Node.js, ripgrep, ffmpeg, sao chép kho lưu trữ, môi trường ảo, và lệnh hermes toàn cục. Khi hoàn tất, bạn đã sẵn sàng để trò chuyện.

Còn thiết lập riêng cho Nix thì sao?

Nếu bạn đang sử dụng Nix (trên NixOS, macOS, hoặc Linux), vẫn có một đường dẫn thiết lập riêng với Nix flake, mô-đun NixOS khai báo, và chế độ container tùy chọn. Hãy xem hướng dẫn Thiết lập Nix & NixOS trong tài liệu chính thức để biết chi tiết.

Nhưng đây là lời khuyên của chúng tôi: hãy thử trình cài đặt phổ quát trước. Đây là đường dẫn được hỗ trợ chính thức, và nó được thiết kế để “chỉ cần chạy là xong.”

Điều kiện tiên quyết: Giữ mọi thứ đơn giản

Trước khi chạy trình cài đặt, hãy đảm bảo bạn có:

Git (bắt buộc trên mọi nền tảng không phải Windows)
curl và xz-utils trên Linux (trình cài đặt tải Node.js dưới dạng tệp .tar.xz)
g++ hoặc build-essential trên Debian/Ubuntu (chỉ khi bạn định sử dụng ứng dụng desktop)

Chỉ vậy thôi! Bạn không cần cài đặt Python, Node.js, ripgrep, hoặc ffmpeg thủ công. Trình cài đặt sẽ tự phát hiện những gì còn thiếu và cài đặt cho bạn.

Trên Debian/Ubuntu, bạn có thể chuẩn bị mọi thứ với:

sudo apt install curl xz-utils build-essential

Sau khi cài đặt

Khi trình cài đặt hoàn tất, hãy tải lại shell của bạn và bắt đầu trò chuyện:

source ~/.bashrc   # hoặc: source ~/.zshrc
hermes             # Bắt đầu trò chuyện!

Cấu hình thiết lập của bạn

Sau khi cài đặt, bạn có thể tinh chỉnh mọi thứ với các lệnh chuyên dụng:

hermes model          # Chọn nhà cung cấp LLM và mô hình
hermes tools          # Cấu hình các công cụ được bật
hermes gateway setup  # Thiết lập các nền tảng nhắn tin
hermes config set     # Đặt các giá trị cấu hình riêng lẻ
hermes config get     # Xem các giá trị cấu hình riêng lẻ
hermes setup          # Hoặc chạy trình hướng dẫn thiết lập đầy đủ

Đường dẫn nhanh nhất: Nous Portal

Đây là một mẹo chuyên nghiệp: nếu bạn muốn bỏ qua việc quản lý nhiều khóa API cho từng công cụ, hãy sử dụng Nous Portal. Một gói đăng ký bao gồm hơn 300 mô hình cộng với Tool Gateway (tìm kiếm web, tạo hình ảnh, TTS, trình duyệt đám mây). Bắt đầu chỉ với một lệnh:

hermes setup --portal

Lệnh này sẽ đăng nhập cho bạn, đặt Nous làm nhà cung cấp, và bật Tool Gateway — tất cả cùng một lúc.

Chuyển từ máy khác?

Nếu bạn đã chạy Hermes trên một máy khác, bạn không cần phải xây dựng lại mọi thứ từ đầu. Khôi phục bản sao lưu đầy đủ bằng hermes import, hoặc mang theo một agent đơn lẻ bằng hermes profile import. Chỉ cần nhớ: xuất profile loại trừ thông tin xác thực theo thiết kế, vì vậy nó không phải là bản sao lưu đầy đủ. Hãy sử dụng hermes backup cho việc đó.

Lời kết

Mặc dù Nix không còn là đường dẫn cài đặt được hỗ trợ chính thức, trình cài đặt phổ quát giúp việc thiết lập dễ dàng hơn bao giờ hết. Đối với hầu hết người dùng, đây là cách nên đi — ngay cả trên NixOS. Nếu bạn gặp sự cố, hướng dẫn riêng cho Nix vẫn có sẵn như một phương án dự phòng.

Trong bài tiếp theo của chuỗi, chúng ta sẽ đi sâu vào việc cấu hình agent đầu tiên của bạn. Cho đến lúc đó, chúc bạn trò chuyện vui vẻ!