본문으로 건너뛰기

Termux를 사용하는 Android의 Hermes

Termux를 통해 Android 휴대폰에서 Hermes Agent를 직접 실행하기 위해 테스트된 경로입니다.

이는 휴대폰에서 작동하는 로컬 CLI와 현재 Android에 깔끔하게 설치되는 것으로 알려진 핵심 추가 기능을 제공합니다.

테스트된 경로에서는 무엇이 지원되나요?​

테스트된 Termux 번들은 다음을 설치합니다.

  • 헤르메스 CLI
  • 크론 지원
  • PTY/백그라운드 터미널 지원
  • 텔레그램 게이트웨이 지원(수동/최선의 백그라운드 실행)
  • MCP 지원
  • 혼쵸 메모리 지원
  • ACP 지원

구체적으로 다음과 같이 매핑됩니다.

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

아직 테스트된 경로의 일부가 아닌 것은 무엇입니까?​

몇 가지 기능에는 Android용으로 게시되지 않았거나 아직 휴대폰에서 검증되지 않은 데스크톱/서버 스타일 종속성이 필요합니다.

  • .[all]은 현재 Android에서 지원되지 않습니다.
  • voice 추가 항목은 faster-whisper -> ctranslate2에 의해 차단되었으며 ctranslate2은 Android 휠을 게시하지 않습니다.
  • Termux 설치 프로그램에서 자동 브라우저/Playwright 부트스트랩을 건너뜁니다.
  • Termux 내에서는 Docker 기반 터미널 격리를 사용할 수 없습니다.
  • Android는 여전히 Termux 백그라운드 작업을 일시 중지할 수 있으므로 게이트웨이 지속성은 일반적인 관리 서비스가 아닌 최선의 노력입니다.

그렇다고 해서 Hermes가 전화 기반 CLI 에이전트로 잘 작동하는 것을 막지는 않습니다. 단지 권장되는 모바일 설치가 데스크톱/서버 설치보다 의도적으로 좁다는 것을 의미합니다.

옵션 1: 한 줄 설치 프로그램​

Hermes는 이제 Termux 인식 설치 프로그램 경로를 제공합니다.

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

Termux에서 설치 프로그램은 자동으로 다음을 수행합니다.

  • 시스템 패키지에 pkg을 사용합니다.
  • python -m venv을 사용하여 venv를 생성합니다.
  • 광범위한 .[termux-all] 추가를 먼저 시도하고 더 작은 .[termux] 추가로 폴백합니다(그런 다음 기본 설치). 컬 설치 프로그램은 이 순서를 자동으로 일치시킵니다.
  • hermes을 $PREFIX/bin에 연결하여 Termux PATH에 유지합니다.
  • 테스트되지 않은 브라우저/WhatsApp 부트스트랩을 건너뜁니다.

명시적인 명령을 원하거나 실패한 설치를 디버깅해야 하는 경우 아래 수동 경로를 사용하세요.

옵션 2: 수동 설치(완전히 명시적)​

1. Termux 업데이트 및 시스템 패키지 설치​

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

왜 이 패키지를 사용하나요?

  • python — 런타임 + Venv 지원
  • git — 저장소 복제/업데이트
  • clang, rust, make, pkg-config, libffi, openssl — Android에서 몇 가지 Python 종속성을 구축하는 데 필요합니다.
  • nodejs — 테스트된 핵심 경로를 넘어서는 실험을 위한 선택적 노드 런타임
  • ripgrep — 빠른 파일 검색
  • ffmpeg — 미디어 / TTS 변환

2. 헤르메스 복제​

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

하위 모듈 없이 이미 복제한 경우:

git submodule update --init --recursive

3. 가상 환경 만들기​

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`은 `jiter`과 같은 Rust/maturin 기반 패키지에 중요합니다.

### 4. 테스트된 Termux 번들 설치 \{#4-install-the-tested-termux-bundle}

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

최소한의 핵심 에이전트만 원하는 경우에도 작동합니다.

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

5. Termux 경로에 hermes을 추가합니다.​

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"
``$PREFIX/bin`은 이미 Termux의 PATH에 있으므로 매번 venv를 다시 활성화하지 않고도 `hermes` 명령이 새 셸에서 지속됩니다.

### 6. 설치 확인 \{#4-install-the-tested-termux-bundle}

```bash
hermes version
hermes doctor

7. 헤르메스를 시작하세요​

hermes

권장되는 후속 조치 설정​

모델 구성​

hermes model

또는 ~/.hermes/.env에서 직접 키를 설정하세요.

hermes setup

선택적 노드 종속성을 수동으로 설치​

테스트된 Termux 경로는 의도적으로 노드/브라우저 부트스트랩을 건너뜁니다. 나중에 브라우저 도구를 실험해 보려면 다음 단계를 따르세요.

pkg install nodejs-lts
npm install

브라우저 도구는 PATH 검색에 Termux 디렉터리(/data/data/com.termux/files/usr/bin)를 자동으로 포함하므로 추가 PATH 구성 없이 agent-browser 및 npx이 검색됩니다.

달리 문서화될 때까지 Android의 브라우저/WhatsApp 도구를 실험적인 것으로 간주하세요.

문제 해결​

No solution found.[all] 설치 시​

대신 테스트된 Termux 번들을 사용하세요.

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

차단기는 현재 voice 추가 항목입니다.

  • voice은 faster-whisper을 가져옵니다.
  • faster-whisper은 ctranslate2에 따라 다릅니다.
  • ctranslate2은 Android 휠을 게시하지 않습니다.

uv pip install이 Android에서 실패합니다.​

대신 stdlib venv + pip과 함께 Termux 경로를 사용하세요.

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이 ANDROID_API_LEVEL에 대해 불만을 제기합니다.​

설치하기 전에 API 수준을 명시적으로 설정합니다.

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

hermes doctor은 ripgrep 또는 Node가 누락되었다고 말합니다.​

Termux 패키지를 사용하여 설치합니다.

pkg install ripgrep nodejs

Python 패키지를 설치하는 동안 빌드 실패​

빌드 도구 체인이 설치되어 있는지 확인하세요.

pkg install clang rust make pkg-config libffi openssl

그런 다음 다시 시도하세요.

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

휴대폰의 알려진 제한 사항​

  • Docker 백엔드를 사용할 수 없습니다.
  • faster-whisper을 통한 로컬 음성 변환은 테스트된 경로에서 사용할 수 없습니다.
  • 설치 프로그램이 브라우저 자동화 설정을 의도적으로 건너뛰었습니다.
  • 일부 선택적 추가 기능이 작동할 수 있지만 .[termux] 및 .[termux-all]만 현재 테스트된 Android 번들로 문서화되어 있습니다.

새로운 Android 관련 문제가 발생한 경우 다음을 사용하여 GitHub 문제를 열어주세요.

  • 당신의 안드로이드 버전
  • termux-info
  • python --version
  • hermes doctor
  • 정확한 설치 명령 및 전체 오류 출력