Chào mừng bạn đến với Bản Cài Đặt Dễ Dàng Nhất Bạn Từng Thực Hiện

Nếu bạn đang trì hoãn việc dùng thử Hermes Agent vì lo lắng quá trình cài đặt phức tạp, thì hãy dừng lại ngay tại đây. Trình cài đặt mới gần như làm hết mọi thứ cho bạn — và tôi thực sự muốn nói là mọi thứ. Trong hướng dẫn này, chúng ta sẽ đưa bạn vào hoạt động trong vòng chưa đầy hai phút, không cần bằng tiến sĩ về thao tác terminal.

Con Đường Nhanh Nhất: Hermes Desktop

Đối với người dùng macOS và Windows, cách dễ nhất tuyệt đối là tải trình cài đặt Hermes Desktop từ trang web của chúng tôi. Tải về, chạy nó, và bạn đã hoàn tất. Nó cài đặt cả công cụ dòng lệnh lẫn ứng dụng desktop, vì vậy bạn có được những gì tốt nhất của cả hai thế giới.

Chỉ Dùng Dòng Lệnh? Không Vấn Đề

Thích ở lại trong terminal? Bạn có hai lựa chọn tùy theo hệ điều hành:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (bản gốc) — chạy trong PowerShell:

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

Đổi ý và muốn dùng ứng dụng desktop sau này? Chỉ cần chạy hermes desktop và nó sẽ lo phần còn lại.

Trình Cài Đặt Thực Sự Làm Gì (Để Bạn Không Phải Làm)

Đây chính là điều kỳ diệu: trình cài đặt xử lý mọi thứ một cách tự động. Không còn phải săn lùng từng dependency một. Nó thiết lập:

Python 3.11 (qua uv, không cần sudo)
Node.js v22 (cho tự động hóa trình duyệt và cầu nối WhatsApp)
ripgrep (cho tìm kiếm tệp cực nhanh)
ffmpeg (cho chuyển đổi âm thanh trong TTS)
Bản sao repo, môi trường ảo, và lệnh hermes toàn cục

Thứ duy nhất bạn cần tự cài đặt là Git (kiểm tra bằng git --version). Trên Linux, cũng đảm bảo curl và xz-utils có sẵn. Đối với ứng dụng desktop, bạn sẽ cần build-essential trên Debian/Ubuntu.

Mọi Thứ Được Lưu Ở Đâu

Tùy thuộc vào cách bạn cài đặt, các tệp sẽ nằm ở những vị trí khác nhau:

Trình cài đặt	Mã nguồn nằm tại	Binary `hermes`	Thư mục dữ liệu
Theo người dùng (trình cài đặt git)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Chế độ root (`sudo curl … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

Bố cục chế độ root hoàn hảo cho các máy dùng chung nơi một bản cài đặt hệ thống phục vụ tất cả mọi người. Cấu hình cá nhân của bạn (xác thực, kỹ năng, phiên làm việc) vẫn nằm an toàn trong thư mục ~/.hermes/ của riêng bạn.

Sau Khi Cài Đặt: Bắt Đầu Trò Chuyện!

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

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

Muốn tinh chỉnh sau này? Có các lệnh chuyên dụng cho việc đó:

hermes model          # Chọn nhà cung cấp LLM và mô hình
hermes tools          # Cấu hình công cụ nào đượ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 đủ

Con Đường Nhanh Nhất: Nous Portal

Đây là mẹo chuyên nghiệp: nếu bạn muốn bỏ qua hoàn toàn việc xoay xở với từng khóa API riêng lẻ, hãy 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). Thiết lập mọi thứ chỉ với một lệnh duy nhất:

hermes setup --portal

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

Chuyển Từ Máy Khác?

Đừng xây dựng lại 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 để có bản sao lưu thực sự, hãy dùng hermes backup.

Lưu Ý Cho Người Dùng Nix

Nix không còn là đường dẫn cài đặt được hỗ trợ tường minh (chỉ cố gắng hết sức). Nếu bạn đã dùng Nix, có một hướng dẫn thiết lập riêng với flake và mô-đun NixOS — xem tài liệu Nix & NixOS Setup.

Chạy Như Một Dịch Vụ Hệ Thống?

Muốn chạy Hermes như một người dùng không đặc quyền chuyên dụng (như tài khoản systemd hermes)? Hoàn toàn được hỗ trợ. Bước duy nhất cần quyền root là --with-deps của Playwright cho các thư viện Chromium. Trình cài đặt sẽ phát hiện sudo có sẵn hay không và xử lý một cách linh hoạt.

Vậy là xong! Bạn đã sẵn sàng bắt đầu cuộc trò chuyện đầu tiên với Hermes. Trong hướng dẫn tiếp theo, chúng ta sẽ khám phá phiên trò chuyện đầu tiên của bạn và tất cả những điều thú vị bạn có thể làm. Hẹn gặp lại bạn ở đó!