튜토리얼 11: Android(Termux)에서 Hermes 실행하기
Tutorial 11: Running Hermes on Android (Termux) — easy-to-understand guide based on official docs
튜토리얼 11: Android(Termux)에서 Hermes 실행하기
헤르메스 탐험가 여러분, 다시 만나요! 이번 튜토리얼에서는 Termux를 사용해 여러분의 Android 휴대폰에서 Hermes Agent를 실행하는 방법을 알아보겠습니다. 네, 맞아요 — 이제 여러분의 주머니 속 기기가 완전한 AI 어시스턴트 허브가 될 수 있습니다. 그리고 가장 좋은 점은? 설치 과정이 훨씬 더 간단해졌다는 거예요.
준비물
본격적으로 시작하기 전에 Termux 환경이 준비되어 있는지 확인해 봅시다. 유일하게 필요한 사전 준비물은 Git입니다. 아직 설치하지 않았다면 Termux를 열고 다음을 실행하세요:
pkg install git curl xz-utils
끝입니다! Python, Node.js, ripgrep, ffmpeg를 수동으로 설치할 필요 없어요 — Hermes 설치 프로그램이 모든 것을 자동으로 처리합니다. 누락된 항목을 감지해서 알아서 설정해 줍니다.
원라인 설치
여기 마법의 명령어가 있습니다. Termux를 열고 실행하세요:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
네, 정말 이렇게 간단합니다. 설치 프로그램이 모든 것을 처리합니다:
- uv (빠른 Python 패키지 매니저)
- Python 3.11 (uv를 통해, sudo 불필요)
- Node.js v22 (브라우저 자동화 및 WhatsApp 브리지용)
- ripgrep (빠른 파일 검색)
- ffmpeg (TTS용 오디오 형식 변환)
또한 저장소를 클론하고, 가상 환경을 설정하며, 전역 hermes 명령어를 생성하고, LLM 제공업체를 구성합니다. 모든 과정이 끝나면 바로 대화를 시작할 준비가 됩니다.
설치 위치
Android/Termux에서는 일반 사용자로 설치하므로 디렉터리 구조는 다음과 같습니다:
| 항목 | 위치 |
|---|---|
| 코드 | ~/.hermes/hermes-agent/ |
hermes 바이너리 |
~/.local/bin/hermes (심볼릭 링크) |
| 데이터 디렉터리 | ~/.hermes/ |
개인 설정(인증, 스킬, 세션)은 ~/.hermes/ 아래에 저장되므로 모든 것이 홈 디렉터리에 깔끔하게 유지됩니다.
대화 시작하기
설치가 완료되면 셸을 리로드하고 Hermes를 실행하세요:
source ~/.bashrc # 또는: source ~/.zshrc
hermes # 대화 시작!
이게 전부입니다 — 이제 Android 기기에서 Hermes와 대화하고 있는 거예요!
설정 구성하기
설치 후에 몇 가지를 조정하고 싶을 수 있습니다. 전용 명령어는 다음과 같습니다:
hermes model # LLM 제공업체와 모델 선택
hermes tools # 활성화할 도구 구성
hermes gateway setup # 메시징 플랫폼 설정
hermes config set # 개별 설정 값 지정
hermes config get # 개별 설정 값 확인
hermes setup # 또는 전체 설정 마법사 실행
가장 빠른 방법: Nous Portal
가장 빠른 설정을 원한다면 Portal 옵션을 사용하세요. 하나의 구독으로 300개 이상의 모델과 Tool Gateway(웹 검색, 이미지 생성, TTS, 클라우드 브라우저)를 이용할 수 있습니다. 더 이상 각 도구별로 API 키를 관리할 필요가 없어요:
hermes setup --portal
이 명령어 하나로 로그인하고, Nous를 제공업체로 설정하며, Tool Gateway를 활성화합니다. 끝입니다.
다른 기기에서 이동?
이미 컴퓨터에서 Hermes를 실행 중인가요? 처음부터 모든 것을 다시 구축할 필요 없습니다. 다음 명령어로 단일 에이전트를 가져올 수 있어요:
hermes profile import
또는 hermes import로 전체 백업을 복원할 수 있습니다. 참고: 프로필 내보내기는 설계상 자격 증명을 제외하므로, 완전한 백업이 필요하다면 hermes backup을 사용하세요.
루트 모드에 대한 참고 사항
Hermes를 루트로 설치하는 경우(sudo curl ... | sudo bash), 디렉터리 구조가 FHS 구조(/usr/local/lib/hermes-agent/ 및 /usr/local/bin/hermes)로 변경됩니다. 이는 하나의 시스템 설치로 모든 사용자가 공유할 수 있는 공용 머신에 유용합니다. 하지만 Termux에서는 사용자별 설치가 완벽합니다.
마무리
이것으로 끝입니다! 이제 Android 기기에서 완전히 작동하는 Hermes Agent를 실행하고 있습니다. 버스 안에서든, 회의 중이든, 소파에 누워 있을 때든, 여러분의 AI 어시스턴트는 항상 주머니 속에 있습니다.
다음 튜토리얼에서는 WhatsApp과 Telegram 같은 메시징 플랫폼에서 Hermes를 사용하는 방법을 알아보겠습니다. 그때까지 즐거운 대화 되세요!
📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › getting-started/termux