Skip to content

2winter-dev/iHermes

iHermes Chat

基于 Expo 的 Hermes 移动优先客户端。
支持 Android、iOS、Web(PWA) 直连你自己的 Hermes Agent。

English · 简体中文

Live Demo Expo Snack Repo

License Platform Expo TypeScript

Stars Forks

快速入口

项目 地址
仓库 https://github.com/2winter-dev/iHermes
Web / PWA 预览 https://ihermes.2winter.com
Snack 演示 https://snack.expo.dev/@yfd/ihermes
Android APK https://github.com/2winter-dev/iHermes/releases/tag/beta0.1

Snack 预览

open-snack

截图预览

Overview
overview
Warm Theme Soft Theme
orange-theme orange-theme-chat orange-theme-chat2 blue-theme blue-theme-chat blue-theme-chat2

功能特性

实例与连接

  • 多实例新增 / 编辑 / 删除 / 切换
  • 连接状态检测与手动刷新
  • 本地保存连接信息

对话体验

  • SSE 流式回复
  • 思考骨架屏 + 阶段提示
  • 工具调用步骤列表(顺序 / 成功失败状态)
  • 重试、复制回复、气泡长按复制

设置能力

  • 主题切换(暖色 / 浅淡)
  • 动画开关
  • 多语言支持:中文 / English,默认跟随设备语言,其他语言回退英文
  • 版本信息、帮助与 FAQ

更新日志(v0.3)

新功能

  • 新增系统分享按钮,可一键分享 iHermes 仓库地址(按钮文案包含当前 App 版本)。
  • 设置页新增“思考过程”开关,并与“动画”归类到“其他”分组。
  • 版本信息区优化:展示“默认模型和数据”,并将分享入口放到同一行。
  • FAQ 新增 iOS 快速使用说明:下载 Expo Go 后扫码即可免安装体验 iHermes。
  • 聊天气泡支持基础 Markdown 渲染(标题、粗体、链接、图片、表格)。
  • 对话过程可视化增强:支持展示工具调用和过程明细,便于排查与理解执行链路。

修复与优化

  • 顶部标题 iHermes Chat 在窄屏下改为单行显示,避免换行。
  • 移除“非流式输出”路径,统一走流式输出,减少行为分叉。
  • 修复设置项“关”状态视觉反馈,关闭时背景色可正确区分。
  • 增强长请求稳定性:支持超时、取消(挂起)与更清晰的错误/状态处理。
  • 改进 Tool 按钮与聊天工具条样式,提升可读性与点击反馈。
  • 修复原生端聊天历史存储容量风险:原生端不再写入大体积历史,避免 SecureStore 尺寸限制问题。

技术栈

  • Expo + React Native + React Native Web
  • TypeScript
  • expo-secure-store / expo-clipboard / @expo/vector-icons
  • Vercel(Web 部署)

本地运行

npm install
npm run start
npm run android
npm run ios
npm run web

Android APK 构建

# 默认(debug)
npm run android:assemble

# 显式 debug / release
npm run android:assemble:debug
npm run android:assemble:release

产物路径:

  • debug: android/app/build/outputs/apk/debug/
  • release: android/app/build/outputs/apk/release/

Expo Go 预览

git clone https://github.com/2winter-dev/iHermes.git
cd iHermes
npm install
npx expo start --tunnel

使用手机 Expo Go 扫码即可预览。

iOS 体验方式

iOS 用户可通过以下两种方式体验 iHermes:

方式一:自行构建编译

git clone https://github.com/2winter-dev/iHermes.git
cd iHermes
npm install
npx expo run:ios

方式二:Expo Go 扫码体验

  1. 在 App Store 下载 Expo Go App
  2. 使用系统相机扫码器扫描下方二维码即可体验

expo-qr

Web/PWA 连接 Hermes 注意事项

  • HTTPS 页面不能直接请求 HTTP 接口(Mixed Content)
  • Hermes 端需要正确配置 CORS

推荐:

  • 使用 Cloudflare Tunnel / Tailscale Funnel 暴露 HTTPS 地址
  • 在 Hermes 或反代层配置 CORS 白名单

项目统计

last-commit issues pr repo-size top-language

参与贡献

License

MIT License. See LICENSE.

About

A mobile-first Hermes client built with Expo. Connect to your own Hermes agent directly from Android / iOS / Web(PWA), with no mandatory backend service.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors