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

Hermes trên Android với Termux

Đây là đường dẫn đã được thử nghiệm để 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 cục bộ đang hoạt động trên điện thoại, cùng với các tính năng bổ sung cốt lõi hiện được biết là có thể cài đặt dễ dàng trên Android.

Đường dẫn đã thử nghiệm hỗ trợ những gì?​

Gói Termux đã được thử nghiệm cài đặt:

  • Hermes CLI
  • hỗ trợ cron
  • Hỗ trợ thiết bị đầu cuối PTY/nền
  • Hỗ trợ MCP
  • Hỗ trợ bộ nhớ Honcho
  • Hỗ trợ ACP

Cụ thể, nó ánh xạ tới:

Python -m pip install -e '.[Termux]' -c constraints-Termux.txt

Phần nào chưa nằm trong đường dẫn được thử nghiệm?​

Một số tính năng vẫn cần phần phụ thuộc kiểu máy tính để bàn/máy chủ chưa được xuất bản cho Android hoặc chưa được xác thực trên điện thoại:

  • .[all] hiện chưa được hỗ trợ trên Android
  • phần bổ sung voice bị faster-whisper -> ctranslate2 chặn và ctranslate2 không xuất bản bánh xe Android
  • trình duyệt tự động / bootstrap của Playwright bị bỏ qua trong trình cài đặt Termux
  • Cách ly thiết bị đầu cuối dựa trên Docker không có sẵn trong Termux

Điều đó không ngăn Hermes hoạt động tốt như một tác nhân CLI gốc trên điện thoại - nó chỉ có nghĩa là cài đặt trên thiết bị di động được đề xuất hẹp hơn so với cài đặt trên máy tính để bàn/máy chủ.

Tùy chọn 1: Trình cài đặt một dòng​

Hermes hiện gửi đường dẫn cài đặt nhận biết 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 với Python -m venv
  • cài đặt .[Termux] với pip
  • liên kết Hermes vào $PREFIX/bin để nó vẫn nằm trên ĐƯỜNG Termux của bạn
  • bỏ qua trình duyệt chưa được kiểm tra / bootstrap WhatsApp

Nếu bạn muốn các lệnh rõ ràng hoặc cần gỡ lỗi cài đặt không thành công, hãy sử dụng đường dẫn thủ công bên dưới.

Cách 2: Cài đặt thủ công (rõ ràng đầy đủ)​

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 những gói này?

  • Python — hỗ trợ thời gian chạy + venv
  • git — sao chép/cập nhật repo
  • clang, Rust, make, pkg-config, libffi, openSSL - cần thiết để xây dựng một số phần phụ thuộc Python trên Android
  • nodejs - Thời gian chạy nút tùy chọn cho các thử nghiệm ngoài đường dẫn cốt lõi đã được thử nghiệm
  • ripgrep - tìm kiếm tập tin nhanh
  • ffmpeg — chuyển đổi phương tiện / TTS

2. Nhân bản Hermes​

git clone --recurse-submodules https://GitHub.com/NousResearch/Hermes-agent.git
cd Hermes-agent

Nếu bạn đã nhân bản mà không có mô-đun con:

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 đối với các gói dựa trên Rust/maturin như jiter.

4. Cài đặt gói Termux đã thử nghiệm​

Python -m pip install -e '.[Termux]' -c constraints-Termux.txt

Nếu bạn chỉ muốn tác nhân cốt lõi tối thiểu, thì điều này cũng hoạt động:

Python -m pip install -e '.' -c constraints-Termux.txt

5. Đặt Hermes vào ĐƯỜNG Termux của bạn​

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

$PREFIX/bin đã có trên PATH trong Termux, vì vậy điều này làm cho lệnh Hermes vẫn tồn tại trên các hệ vỏ mới mà không cần kích hoạt lại venv mỗi lần.

6. Xác minh cài đặt​

Hermes version
Hermes doctor

7. Khởi động Hermes​

Hermes

Đề xuất thiết lập theo dõi​

Định cấu hình mô hình​

Hermes model

Hoặc đặt khóa 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​

Hermes setup

Cài đặt thủ công các phần phụ thuộc của nút tùy chọn​

Đường dẫn Termux đã được thử nghiệm bỏ qua việc khởi động nút/trình duyệt có mục đích. Nếu bạn muốn thử nghiệm sau:

npm install

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.

Khắc phục sự cố​

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

Thay vào đó hãy sử dụng gói Termux đã được thử nghiệm:

Python -m pip install -e '.[Termux]' -c constraints-Termux.txt

Trình chặn hiện là voice bổ sung:

  • voice kéo faster-whisper
  • faster-whisper phụ thuộc vào ctranslate2
  • ctranslate2 không xuất bản bánh xe Android

uv pip install bị lỗi trên Android​

Thay vào đó, hãy sử dụng đường dẫn Termux với stdlib venv + pip:

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 phàn nàn về ANDROID_API_LEVEL​

Đặt cấp API 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 với các gói Termux:

pkg install ripgrep nodejs

Phát sinh lỗi khi cài đặt gói Python​

Đảm bảo chuỗi công cụ xây dựng đã đượ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

---## Những hạn chế đã biết trên điện thoại

  • Phần phụ trợ Docker không khả dụng
  • bản ghi giọng nói cục bộ qua faster-whisper không khả dụng trên đường dẫn đã thử nghiệm
  • trình cài đặt cố tình bỏ qua việc thiết lập tự động hóa trình duyệt
  • một số tính năng bổ sung tùy chọn có thể hoạt động, nhưng hiện chỉ .[Termux] được ghi nhận là gói Android đã thử nghiệm

Nếu bạn gặp phải sự cố mới dành riêng cho Android, vui lòng mở sự cố GitHub bằng:

  • 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à đầu ra lỗi đầy đủ