Chuyển tới nội dung chính

Hermes trên Android với Termux

Đây là quy trình đã được kiểm thử để chạy Hermes Agent trực tiếp trên điện thoại Android thông qua Termux.

Nó cung cấp cho bạn một CLI hoạt động trên điện thoại, cùng với các tiện ích mở rộng cốt lõi hiện đã được xác nhận cài đặt trơn tru trên Android.

Những gì được hỗ trợ trong quy trình đã kiểm thử?​

Bộ cài Termux đã kiểm thử bao gồm:

  • Hermes CLI
  • Hỗ trợ cron
  • Hỗ trợ PTY/terminal nền
  • Hỗ trợ MCP
  • Hỗ trợ bộ nhớ Honcho
  • Hỗ trợ ACP

Cụ thể, nó tương ứng với:

python -m pip install -e '.[termux]' -c constraints-termux.txt

The browser tool automatically includes Termux directories (/data/data/com.termux/files/usr/bin) in its PATH search, so agent-browser and npx are discovered without any extra PATH configuration.

The browser tool automatically includes Termux directories (/data/data/com.termux/files/usr/bin) in its PATH search, so agent-browser and npx are discovered without any extra PATH configuration.

Những gì chưa nằm trong quy trình đã kiểm thử?​

Một số tính năng vẫn cần các dependency dạng desktop/server chưa được phát hành cho Android, hoặc chưa được xác thực trên điện thoại:

  • .[all] chưa được hỗ trợ trên Android
  • Tiện ích voice bị chặn bởi faster-whisper -> ctranslate2, và ctranslate2 không phát hành wheel cho Android
  • Việc khởi tạo tự động trình duyệt / Playwright bị bỏ qua trong trình cài đặt Termux
  • Cách ly terminal qua Docker không khả dụng bên trong Termux

Điều đó không ngăn Hermes hoạt động tốt như một CLI agent trên điện thoại — chỉ có nghĩa là bản cài đặt di động được khuyến nghị có phạm vi hẹp hơn so với bản desktop/server.

Tùy chọn 1: Cài đặt một dòng​

Hermes hiện có quy trình cài đặt nhận diện Termux:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Trên Termux, trình cài đặt tự động:

  • Sử dụng pkg cho các gói hệ thống
  • Tạo venv bằng python -m venv
  • Cài đặt .[termux] bằng pip
  • Liên kết hermes vào $PREFIX/bin để nó luôn có trong PATH của Termux
  • Bỏ qua phần khởi tạo trình duyệt / WhatsApp chưa được kiểm thử

Nếu bạn muốn xem các lệnh cụ thể hoặc cần gỡ lỗi cài đặt thất bại, hãy sử dụng quy trình thủ công bên dưới.

Tùy chọn 2: Cài đặt thủ công (đầy đủ chi tiết)​

1. Cập nhật Termux và cài đặt các gói hệ thống​

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

Tại sao cần các gói này?

  • python — runtime + hỗ trợ venv
  • git — clone/cập nhật repository
  • clang, rust, make, pkg-config, libffi, openssl — cần thiết để build một số dependency Python trên Android
  • nodejs — runtime Node tùy chọn cho các thử nghiệm ngoài phạm vi cốt lõi đã kiểm thử
  • ripgrep — tìm kiếm file nhanh
  • ffmpeg — chuyển đổi media / TTS

2. Clone Hermes​

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Nếu bạn đã clone mà không có submodules:

git submodule update --init --recursive

3. Tạo môi trường ảo​

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

ANDROID_API_LEVEL rất quan trọng cho các gói dựa trên Rust / maturin như jiter.

4. Cài đặt bộ Termux đã kiểm thử​

python -m pip install -e '.[termux]' -c constraints-termux.txt

Nếu bạn chỉ muốn agent lõi tối thiểu, lệnh này cũng hoạt động:

python -m pip install -e '.' -c constraints-termux.txt

5. Đưa hermes vào PATH của Termux​

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

$PREFIX/bin đã có sẵn trong PATH của Termux, do đó lệnh hermes sẽ hoạt động trong các shell mới mà không cần phải kích hoạt lại venv mỗi lần.

6. Kiểm tra cài đặt​

hermes version
hermes doctor

7. Khởi động Hermes​

hermes

Thiết lập bổ sung khuyến nghị​

Cấu hình model​

hermes model

Hoặc thiết lập key trực tiếp trong ~/.hermes/.env.

Chạy lại trình hướng dẫn thiết lập tương tác đầy đủ sau này​

hermes setup

Cài đặt dependency Node tùy chọn thủ công​

Quy trình Termux đã kiểm thử cố tình bỏ qua phần khởi tạo Node/trình duyệt. Nếu bạn muốn thử nghiệm công cụ trình duyệt sau:

pkg install nodejs-lts
npm install

Công cụ trình duyệt tự động bao gồm các thư mục Termux (/data/data/com.termux/files/usr/bin) trong tìm kiếm PATH, do đó agent-browser và npx được phát hiện mà không cần cấu hình PATH bổ sung.

Hãy coi công cụ trình duyệt / WhatsApp trên Android là thử nghiệm cho đến khi có tài liệu khác.

Xử lý sự cố​

No solution found khi cài đặt .[all]​

Hãy sử dụng bộ Termux đã kiểm thử thay thế:

python -m pip install -e '.[termux]' -c constraints-termux.txt

Nguyên nhân hiện tại là tiện ích voice:

  • voice kéo theo faster-whisper
  • faster-whisper phụ thuộc vào ctranslate2
  • ctranslate2 không phát hành wheel cho Android

uv pip install thất bại trên Android​

Hãy sử dụng quy trình Termux với venv stdlib + pip thay thế:

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt

jiter / maturin báo lỗi về ANDROID_API_LEVEL​

Thiết lập API level rõ ràng trước khi cài đặt:

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install -e '.[termux]' -c constraints-termux.txt

hermes doctor báo thiếu ripgrep hoặc Node​

Cài đặt chúng bằng gói Termux:

pkg install ripgrep nodejs

Lỗi build khi cài đặt gói Python​

Đảm bảo bộ công cụ build đã được cài đặt:

pkg install clang rust make pkg-config libffi openssl

Sau đó thử lại:

python -m pip install -e '.[termux]' -c constraints-termux.txt

Hạn chế đã biết trên điện thoại​

  • Docker backend không khả dụng
  • Phiên âm giọng nói cục bộ qua faster-whisper không khả dụng trong quy trình đã kiểm thử
  • Thiết lập tự động hóa trình duyệt bị trình cài đặt cố tình bỏ qua
  • Một số tiện ích tùy chọn có thể hoạt động, nhưng chỉ .[termux] hiện được ghi nhận là bộ Android đã kiểm thử

Nếu bạn gặp sự cố mới đặc thù Android, vui lòng mở issue trên GitHub với:

  • Phiên bản Android của bạn
  • termux-info
  • python --version
  • hermes doctor
  • Lệnh cài đặt chính xác và toàn bộ đầu ra lỗi