📦rusty4444 / hermes-android
← 返回首页
Android client for Hermes Agent - chat with your Hermes sessions from a phone or tablet over local Wi-Fi or a private Tailscale network.
⚖️ MIT#ai-assistant#android#chat#dart#flutter📅 创建于 2026-05-27🔄 更新于 2026-11-01

📄 仓库 README

在 GitHub 查看 ↗
来自 GitHub 仓库自述文件 · 版权归原作者所有

Hermes Android 3.0.0 announcement

Hermes Android v3.1.7

Android client for Hermes Agent — chat with your Hermes sessions from a phone or tablet over local Wi-Fi or a private Tailscale network.

Screenshots

Ten fresh Android emulator captures, each using a different colour palette. These show the production-signed RC3 UI retained in 3.0.0, with illustrative demo conversations and files rather than private account data. The live-work example uses a local test gateway, not a model response. See capture details.

Chats in the Gold · dark theme
Chats · Gold · dark
Crons in the Purple · dark theme
Crons · Purple · dark
Activity in the Orange · light theme
Activity · Orange · light
More in the Green · dark theme
More · Green · dark
Settings in the Blue · light theme
Settings · Blue · light
Appearance in the Red · light theme
Appearance · Red · light
Conversation in the Teal · dark theme
Conversation · Teal · dark
Assets in the Pink · dark theme
Assets · Pink · dark
Archived chats in the Indigo · light theme
Archived chats · Indigo · light
Live work and Stop/Send in the Cyan · dark theme
Live work and Stop/Send · Cyan · dark

v2.0.0 merges the community Remote Gateway edition contributed by @CristianGCiocoi, with review and testing from @AI-Guru and @grunjol. The merge brings a unified Desktop Gateway JSON-RPC transport, per-chat model selection, multi-attachment uploads, durable turn recovery, voice dictation, and a comprehensive test suite. See CHANGELOG.md for the full list and the merge PR thread for the community discussion.

Current release

3.1.7 (base build 3020) adds LAN discovery for finding Hermes instances on the local network. The production package, com.hermesagent.hermes_android, and signing identity stay the same. Export an encrypted configuration backup before updating; the matching production-signed APK upgrades 3.1.6 and every earlier 3.1 RC in place. Do not uninstall or clear app data.

Download Device Version code
ARM64 APK Most current Android phones/tablets 30202
ARMv7 APK Older 32-bit ARM devices 30201
x86_64 APK x86_64 Android devices/emulators 30203

Release and checksums · 3.1.7 release notes · Full changelog

Debug builds use the separate com.hermesagent.hermes_android.dev package and Android debug certificate. Older production APKs have lower version codes; downgrading can require uninstalling and restoring a backup.

Before updating

  • Updating the APK does not install or configure Hermes host software or the optional mobile-push server companion.
  • Quiet mode requires completion metadata for each reply. If an older gateway's saved answers are missing in quiet mode, enable Verbose Mode. Saved/live duplicate handover also needs the gateway's optional complete persisted_turn receipt and fresh history; older gateways can retain both sources.
  • Assets is partial discovery of shared files, not a complete attachment or filesystem catalogue. Downloads are limited to 25 MiB per file.
  • Protect encrypted backups and their passwords. Backups can contain connection secrets and imported client private keys. See the upgrade notes and compatibility limits.

Update checks

The app checks GitHub Releases on ordinary launches. An answered check limits requests to once every 12 hours; offline attempts may retry on the next launch. The dialog offers a newer build but does not download or install it. Later asks again on the next launch; Skip this version stays quiet until another version appears. Shares and Quick Chat shortcuts are not interrupted. In Settings → About, use Check for updates or disable Check for updates on launch. Backups include these choices, not HTTP response caches.

Unpublished integrated candidate: 3.2.0-rc.3

The local candidate identity is 3.2.0-rc.3+3023, with expected release split codes 30231 (ARMv7), 30232 (ARM64) and 30233 (x86_64), all above the published RC.2 maximum 30223. 3.1.7 remains latest published stable; there is no RC.3 APK or download claim. Published RC.2 ancestry and materials are preserved; its original preparation notes below are historical, not its current publication status or RC.3 validation evidence.

  • More → Usage → Provider sign-in and Settings → Provider sign-in use the audited Dashboard device-code flow for Nous, OpenAI Codex, MiniMax and xAI. Anthropic is external-only; OpenRouter is absent from this OAuth catalog. API-server and Desktop RPC transports do not support this sign-in flow.
  • Sign-in opens an external browser only on explicit tap. Temporary device codes stay in route memory; provider tokens stay on the host. Requests preserve saved origin/prefix, selected profile, authentication and mTLS, and reject redirects.
  • Approval means Approval received; account verification unavailable, never Signed in as: completed-session identity is historical, not current-account verification. Approval refreshes only the same-profile OAuth catalog, not generic model/analytics requests. If catalog loading fails, close and reopen the sign-in screen to reload it; there is no in-screen catalog retry action.
  • Usage keeps recorded activity separate from host-reported account allowances. Only reported five-hour/session and weekly windows, percentages and resets are shown; missing values stay unavailable. Codex and Claude OAuth allowances remain separate from paid API access. All 11 shipped ARB locales retain translations for the 32 OAuth and 15 quota keys.

OAuth head b281b9de has independent security approval with no blockers and 214 focused tests plus fatal analysis passed. Usage head 1003963 has independent approval and 4,974 full-suite tests passed. These are component receipts, not a full-suite pass on this release candidate. Final main ancestry integration, candidate full-suite, exact-head quality/native/push CI, signing, published-asset verification and real-account/device acceptance remain release-owner gates. Feature PRs #243 and #245 are not claimed merged by this local preparation. See RC.3 scope and remaining gates.

Integrated local release candidate: 3.2.0-rc.2

The source identity is 3.2.0-rc.2+3022, with expected release split codes 30221 (ARMv7), 30222 (ARM64) and 30223 (x86_64), each above the RC.1 maximum 30213. Unpublished; candidate validation and signed-build verification are pending. 3.1.7 remains the latest published stable. No candidate download is offered here. Draft PR #243 is open and unmerged; this isolated candidate is not a merge into main or a stable promotion.

This candidate implements one More → Usage section for Nous, OpenRouter, OpenAI, Claude and DeepSeek. Hermes-recorded activity stays separate from host-reported account allowance via model.options. OpenAI Codex subscription allowance is distinct from paid OpenAI API access; Claude OAuth allowance is not paid Claude API billing. Session/weekly remaining percentages and reset times appear only where the backend actually reports them; no daily quota is exposed. Missing values stay unavailable; no token or monetary allowance is invented. Account pools retain individual accounts rather than an averaged quota. New quota strings use English fallback in non-English locales.

Feature validation passed independently, including 4,966 full-suite tests and fatal analysis, with no review blockers; native and push CI passed. Those are feature results, not completed candidate gates: the combined candidate's full suite and Linux quality remain pending. Validation uses mocked provider responses, not real-account or real-device acceptance. Exist

📈 近 7 天 Star 趋势

每日新增 Star(柱)与累计 Star(线)· 数据来自 GitHub

🏆 排名变化趋势

在各榜单中的排名历史(数字越小越靠前)

📋 历史上榜记录

每次快照的详细数据
日期 榜单 排名 周期新增 总 STAR