uzairansaruzi/hermex

Hermex – 자체 호스팅된 Hermes AI 에이전트용 iPhone 클라이언트

무엇인가요 – Hermex는 자신이 운영하는 hermes‑webui 서버를 제어할 수 있는 네이티브 iOS 18+ SwiftUI 앱입니다. 이 서버는 AI 에이전트(일반적으로 대규모 언어모델 기반 챗봇)와 그 도구, 메모리, 스케줄된 작업을 호스팅합니다. Hermex는 오직 제어 평면(control plane)에 불과합니다: 명령을 전송하고, 채팅을 스트리밍하며, 데이터를 표시하지만, 모든 모델 추론과 데이터는 당신의 자체 기기에 머물러 있습니다.

왜 중요한가요 – 프라이버시를 우선시하는 사용자들이 제3자 중계, 분석, 구독료 없이 스마트폰에서 자신의 LLM 기반 에이전트와 상호작용할 수 있는 방법을 제공합니다. 앱은 오픈소스이며 MIT 라이선스 하에 있으며, 실제 SwiftUI로 구현되었으며 웹 래퍼 없이 개발되었습니다.

핵심 기능 (README에 기술됨)

기능	수행 가능한 작업
채팅	메시지 전송, 모델/공급자 선택, 추론 노력 설정, 워크스페이스 및 프로필 지정; 파일/이미지 첨부; 도구 호출 세부 정보를 포함한 스트리밍 응답 시청.
실행 조정	생성 중에 일시정지, 재개 또는 중단 가능.
세션	서버에 저장된 모든 대화를 탐색, 검색, 재개; 세션은 로컬에 캐시되어 오프라인 읽기 가능.
모델 선택기	서버가 구성한 모든 모델 간 전환 가능; 즐겨찾기 및 최근 사용 모델은 저장됨.
프로필 및 프로젝트	에이전트의 프로필(예: 시스템 프롬프트) 변경 및 세션을 프로젝트로 그룹화.
작업	스마트폰에서 직접 에이전트의 cron 스타일 스케줄 작업을 보기 및 편집.
스킬	서버에 설치된 "스킬"(도구 플러그인) 목록을 탐색 및 검색.
워크스페이스 브라우저	앱에서 서버의 파일 시스템 탐색.
메모리 및 인사이트	에이전트의 메모리 저장소와 사용 분석을 읽기 전용으로 표시.

시작하기 (사용자 측)

hermes‑webui 서버 실행 – 당신이 제어할 수 있는 어떤 기기(맥OS, 리눅스, 윈도우/WSL2)에서. Python 3.11+ 와 환경 변수 HERMES_WEBUI_PASSWORD 필요.
iPhone에 서버 노출 – 다음 중 하나의 추천 방법 사용:
- HTTPS 터널 또는 역방향 프록시 (예: Cloudflare Tunnel) – 권장.
- Tailscale Serve를 사용한 개인용 HTTPS.
- 로컬 테스트용으로, 서버가 같은 맥에서 실행 중일 경우 http://localhost:8787.
App Store에서 Hermex 설치 (또는 소스에서 빌드)하고 서버 URL과 비밀번호 입력.
앱은 /health 엔드포인트를 검증한 후 채팅 시작, 작업 관리 등 가능.

앱 자체 빌드하기

요구사항 – Xcode 26 (iOS 18 SDK) 이상, iPhone 또는 iOS 18+ 시뮬레이터.
단계 – 리포지토리 복제, HermesMobile.xcodeproj 열기, HermesMobile 스킴 실행. 종속성은 Swift Package Manager로 자동 가져옴.
CLI 빌드 예시:

xcodebuild -project HermesMobile.xcodeproj \
  -scheme HermesMobile \
  -destination 'platform=iOS Simulator,name=iPhone 17' build

테스트는 xcodebuild test로 유사하게 실행 가능.

호환성 참고사항

앱은 특정 hermes-webui 커밋(기록된 UPSTREAM_TESTED_SHA)에 대해 테스트됨. 상류 API는 여전히 불안정하므로, 최신 또는 이전 서버 버전은 일부 기능이 작동하지 않을 수 있음. 앱은 알 수 없는 JSON 필드를 수용하며, 서버가 다른 릴리스를 보고할 경우 "검증되지 않은 Hermes 버전" 경고를 표시.
별도의 "봇 모드" 연결은 고정된 hermes-agent 버전(HERMES_AGENT_TESTED_SHA) 사용.

기여 및 커뮤니티

가이드라인 – 코드 합의, 종속성 규칙, PR 워크플로우는 CONTRIBUTING.md 및 AGENTS.md 참조.
버그 보고 – 리포지토리에 이슈 열기; 취약점 공개는 SECURITY.md 사용.
지원 – 프로젝트는 무료지만, 스타, X에서 팔로우, 커피 기부 환영.

라이선스

MIT 라이선스 (see LICENSE).
아이콘 자산은 Apache‑2.0 및 MIT 라이선스의 제3자 아이콘 세트 사용.

TL;DR

Hermex는 프라이버시 중심의 iOS 클라이언트로, 자체 호스팅된 Hermes AI 에이전트와 대화하고, 조정하며, 관리할 수 있게 해줍니다. 오픈소스 hermes‑webui 서버를 직접 실행한 후 HTTPS(또는 Tailscale)를 통해 연결해야 합니다. 앱은 무료, 오픈소스이며 iOS 18+의 네이티브 SwiftUI로 구축되었습니다.