Hermes Mobile 안드로이드 앱 설치하고 기존 Hermes와 연결하는 방법

개요

본 포스트는 GitHub에 공개된 Hermes Mobile 저장소를 기준으로 안드로이드 앱 여부, iOS 여부, 기존 Hermes 연결 방법, 최신 릴리즈 변경점을 확인하는 과정을 설명합니다.

오늘 기준 공식 모바일 저장소로 확인한 것은 Hy4ri/hermes-mobile입니다. 저장소 구조는 Kotlin, Jetpack Compose, Gradle 기반이며, 릴리즈 자산도 apk 파일로 올라와 있습니다. 반대로 같은 저장소 안에서 iOS, Swift, Xcode, TestFlight, App Store 배포 정보는 확인되지 않았습니다.

따라서 이 글은 GitHub 기준 공식 Hermes Mobile 안드로이드 앱 중심으로 정리합니다.

전체 구성 흐름

Hermes Mobile을 이해할 때는 앱 하나만 보지 말고 기존 Hermes와 연결되는 구조를 같이 봐야 합니다.

• Hermes 본체: 기존 PC나 서버에서 실행 중인 Hermes Agent.
• 모바일 앱: Android에서 Hermes 상태와 작업을 보는 클라이언트.
• 연결 정보: 대시보드, API, WebSocket 게이트웨이, 인증 토큰 또는 로그인 정보.
• 운영 화면: 채팅, 세션, 크론, MCP, 모델, 플러그인, 로그, 프로필 관리.
• 배포 범위: GitHub 릴리즈 기준 Android APK 확인, iOS 공식 저장소는 미확인.

적용 대상

다음 상황이면 바로 볼 만합니다.

• 이미 Hermes를 데스크톱이나 서버에 설치해 둔 상태.
• 폰에서 세션, 크론, 로그, 모델, MCP 상태를 빠르게 확인하고 싶은 상태.
• Telegram이나 Discord처럼 별도 채널만 쓰다가 모바일 전용 화면도 확인하고 싶은 상태.
• GitHub 릴리즈 기준으로 안드로이드 APK를 직접 설치해 테스트할 수 있는 상태.

다음 상황이면 조금 더 확인이 필요합니다.

• iPhone용 공식 Hermes Mobile 앱을 찾는 상태.
• Play Store/App Store 등록 여부만 기준으로 설치하려는 상태.
• Hermes 본체 없이 모바일 앱만 단독 AI 앱처럼 쓰려는 상태.

1. GitHub 기준 플랫폼 범위

직접 확인한 저장소는 Hy4ri/hermes-mobile입니다.

루트 구조는 Android 프로젝트에 맞춰져 있습니다.

app/
build.gradle.kts
gradle/
gradlew
gradlew.bat
settings.gradle.kts

README와 저장소 파일 기준으로 확인한 내용은 다음과 같습니다.

• Android: README 배지, Kotlin, Jetpack Compose, Gradle, minSdk, targetSdk 확인.
• 릴리즈 자산: hermes-mobile-v1.13.1.apk 확인.
• iOS: 같은 저장소에서 ios, Swift, Xcode, TestFlight, App Store 정보 미확인.
• 같은 GitHub 사용자 저장소: hermes-mobile 외 iOS용 별도 Hermes 모바일 저장소 미확인.

즉 GitHub만 기준으로 보면 Android 앱은 확실하고, iOS 공식 앱은 아직 확인되지 않았다고 보는 것이 맞습니다.

2. 다운로드 경로

오늘 기준 최신 릴리즈는 v1.13.1입니다.

• 최신 릴리즈 페이지
• v1.13.1 릴리즈 페이지
• APK 직접 다운로드

Android에서 직접 설치하려면 APK를 내려받은 뒤, 알 수 없는 앱 설치 허용을 켜고 설치하시면 됩니다.

소스에서 직접 빌드하려면 README 기준으로 아래 흐름입니다.

git clone https://github.com/Hy4ri/hermes-mobile.git
cd hermes-mobile
./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk

3. 기존 Hermes 연결 방법

기존 Hermes가 있으면 모바일 앱은 새 백엔드를 만드는 것이 아니라 기존 Hermes 게이트웨이에 붙는 방식입니다. README 기준 앱은 Hermes gateway의 REST API와 WebSocket TUI Gateway에 연결합니다.

대시보드를 로컬에서만 볼 때는 아래처럼 실행합니다.

hermes dashboard

같은 Wi-Fi의 휴대폰에서 접근해야 한다면 LAN 바인딩이 필요합니다.

hermes dashboard --host 0.0.0.0

LAN에 열 경우에는 Basic Auth를 설정해주는 쪽이 안전합니다.

dashboard:
  basic_auth:
    username: admin
    password: hermes

앱에서 연결할 때는 다음 값을 확인하시면 됩니다.

• Host: Hermes가 실행 중인 PC 또는 서버의 LAN IP.
• Port: 대시보드 또는 게이트웨이 포트.
• Token only: ~/.hermes/dashboard-token.txt 또는 ~/.hermes/.env의 HERMES_DASHBOARD_SESSION_TOKEN.
• Basic auth: ~/.hermes/config.yaml에 넣은 사용자명과 비밀번호.

앞서 작성한 Hermes 크론 작업 글을 따라 크론과 Telegram 알림까지 붙여두었다면, 모바일에서 작업 상태를 확인하기가 더 편합니다.

• 관련 글

4. v1.13.1 변경점

오늘 나온 최신 릴리즈는 v1.13.1입니다.

fix(chat): support session IDs containing slashes in Retrofit endpoints

이 변경은 기능이 크게 늘어난 업데이트라기보다, 세션 ID 안에 /가 들어갈 때 Retrofit endpoint가 깨질 수 있는 문제를 고친 성격입니다. 세션을 열거나 이어받는 과정에서 특정 ID만 실패했다면 이 버전으로 올려보는 것이 맞습니다.

5. 직전 v1.13.0에서 추가된 항목

실제로 기능이 크게 늘어난 릴리즈는 바로 직전 v1.13.0입니다. 주요 변경은 아래처럼 묶을 수 있습니다.

• Achievements tab: 대시보드와 기능 동등성 강화.
• Webhooks tab: 구독 생성, 토글, 삭제 지원.
• Config UI: 스키마 기반 설정 화면, 카테고리 탭, 검색, 타입별 입력 지원.
• Models tab: 모델 설정, 보조 작업, MOA 설정 보강.
• Plugins tab: URL 설치, provider 선택, 삭제 확인, 배지 지원.
• Sessions tab: 대시보드 기능 보강.
• System tab: 대시보드와 1:1에 가까운 기능 확장.
• Profiles: 프로필 복제와 설명 수정.
• MCP tab: 서버 추가, 카탈로그, 환경 변수, 재시작, 진단 지원.
• Env keys: 분류, 추가, 삭제, 검색, 게이트웨이 재시작 지원.
• Telegram onboarding: 플랫폼 제거, 자격 증명 만료, 필드 검증 지원.

오늘 버전은 안정성 보강 쪽이고, 직전 버전은 모바일 운영 화면 확장 쪽으로 보는 것이 맞습니다.

6. iOS 여부 확인

GitHub 기준으로는 iOS용 공식 Hermes Mobile 저장소를 확인하지 못했습니다.

확인한 기준은 아래와 같습니다.

• Hy4ri/hermes-mobile README에 iOS, App Store, TestFlight 문구 없음.
• 저장소 루트에 ios, xcodeproj, xcworkspace, Swift 관련 구조 없음.
• 최신 릴리즈 자산은 APK와 version.txt만 확인.
• 같은 GitHub 사용자 저장소에서 별도 iOS용 Hermes Mobile 저장소 미확인.

App Store에는 Hermes라는 이름이 들어간 앱이 여러 개 보입니다. 다만 GitHub 공식 저장소와 직접 연결되지 않은 후보를 공식 Hermes Mobile로 단정하면 안 됩니다.

확인

Android 기준 최신 APK는 최신 릴리즈 주소에서 확인합니다.

Hermes 대시보드를 LAN에서 열어 모바일 접근을 확인합니다.

hermes dashboard --host 0.0.0.0

앱에서 호스트, 포트, 토큰 또는 Basic Auth 정보를 넣은 뒤 세션 목록, 크론 작업, MCP 상태 중 하나라도 정상적으로 열리면 기존 Hermes 연결은 정상입니다.

주요 오류 및 해결 방안

• 앱이 기존 Hermes를 못 찾는 경우: 제 경우 원인은 대부분 Hermes가 127.0.0.1에만 묶인 상태였습니다. 휴대폰에서 접근하려면 --host 0.0.0.0으로 다시 띄워야 할 가능성이 높습니다.
• iOS 앱을 찾다가 다른 앱이 나오는 경우: App Store에는 Hermes 이름을 쓰는 앱이 여러 개 있습니다. GitHub 공식 저장소와 연결되지 않은 앱은 이 글의 Hermes Mobile과 같은 앱으로 보지 않는 것이 안전합니다.
• APK 설치가 막히는 경우: Android 보안 설정에서 해당 브라우저나 파일 앱의 알 수 없는 앱 설치 권한을 켜야 합니다.
• 특정 세션만 열리지 않는 경우: 세션 ID에 /가 들어간 케이스일 수 있습니다. v1.13.1에서 이 문제가 수정되었으므로 최신 APK로 올려보시면 됩니다.