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ợ terminal PTY/nền
  • Hỗ trợ cổng Telegram (chạy nền thủ công / nỗ lực tối đa)
  • 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 terminal dựa trên Docker không có sẵn trong Termux
- Android có thể vẫn tạm dừng các tác vụ nền của Termux, do đó, việc duy trì cổng là nỗ lực tốt nhất thay vì dịch vụ được quản lý thông thường

Đ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:

``` bash
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

- thử phần bổ sung 

.[Termux-all]
` rộng trước và quay trở lại phần bổ sung 

.[Termux]
` nhỏ hơn (sau đó là cài đặt cơ sở) — trình cài đặt cuộn tròn tự động khớp với thứ tự này
- 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

``` bash
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

``` bash
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:

`bash
git submodule update --init --recursive

`

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

`bash
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

`bash
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:

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

`

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

`bash
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

`bash
Hermes version
Hermes doctor

`

### 7. Khởi động Hermes

`bash
Hermes

`

---

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

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

`bash
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

`bash
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 sau này bạn muốn thử nghiệm công cụ trình duyệt:

`bash
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 của nó, do đó 
`agent-browser
` và 
`npx
` được phát hiện mà không cần bất kỳ cấu hình PATH bổ sung nào.

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:

`bash
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

:

``` bash
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:

`bash
 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:

`bash
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:

`bash
pkg install clang Rust make pkg-config libffi openSSL

`
``Sau đó thử lại:

`bash
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 âm 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]
` và 

.[Termux-all]
` đượ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 đủ