New app: Hermes WebUI

Abstract for new app inclusion

Please introduce the functions and usage of your app in summary, and also attach some screenshots.

Hermes WebUI is the Android companion for a self-hosted Hermes WebUI server. You enter your own server URL. The app then hosts the web interface in a hardened WebView and adds Android integration: the share sheet and file uploads, downloads, notifications, microphone access for voice input, and encrypted multi-server settings. It only connects to servers the user sets up, and it contains no tracking, ads, or Google Play libraries.

The F-Droid build (com.hermeswebui.android.fdroid) is the upstream release build type. It installs side by side with the Google Play and GitHub builds and has in-app update checks turned off. Upstream does not provide screenshots yet.

Please elaborate why you wrote this app. Please highlight the unique functions it provides over other similar apps in F-Droid.

Hermes WebUI is a self-hosted AI agent interface. A plain browser tab doesn't work well for it on Android: it's missing native sharing and file handoff, notifications, and the WebView compatibility fixes the app adds. As far as I know, F-Droid has no similar client for Hermes WebUI.

Checklist

Policy

  • The app complies with the inclusion policy. Pay special attention to Quality point 6.
  • The original app author has been notified (and does not oppose the inclusion). This submission comes from the upstream maintainers: hermes-webui/hermes-android#141.
  • The upstream app source code repo contains the app metadata in a Fastlane or Triple-T folder structure. Title, summary, and description are included in en-US; images and changelogs aren't there yet.

Docs

Merge Request Setup

  • The title of this merge request should follow "New app: app name" format.
  • Please make sure your fdroiddata fork is public and your branch is not protected. See https://docs.gitlab.com/user/project/repository/branches/protected/.
  • Please read our Git guide if you don't know how to rebase your branch. Don't rebase your branch if there is no conflict.
  • All related fdroiddata and RFP issues have been referenced in this merge request. There's no RFP issue; the upstream tracking issue is linked above.
  • Please only submit one app in one MR.

Metadata

  • Metadata must be put in metadata/<applicationId>.yml.
  • Metadata must be a valid YAML file.
  • Metadata must use LF as line ending.
  • Don't add summary/description/changelog/images or anything that should be provided in upstream repo. Please check the Changes tab to make sure there is no other unrelated files added in the MR.
  • Releases are tagged and auto update is enabled unless there is a special reason.
  • There is an issue tracker and contact info of the author so that we can report bugs and contact the author.
  • An AuthorName must be added. It doesn't need to be the real name.
  • External repos are added as git submodules instead of srclibs. The app doesn't use any external repos or srclibs.
  • Enable Reproducible Builds. Not enabled. This build uses its own application ID and is meant to be signed by F-Droid, and upstream doesn't publish a matching signed APK for it.
  • Setup abi split if the APK is large and the splitted ones can be much smaller. Not needed: the unsigned APK is about 2.6 MB.
  • Only the latest versions should be kept in the metadata before it's merged. If you update the metadata, please replace the old versions with the new ones.
  • Don't add any disabled versions in the metadata.
  • The commit field should be the full hash. Please don't use tag or branch in commit.

Pipeline

  • All pipelines should pass. I'll check once CI runs.
  • All warnings and errors in the Reports tab should be fixed or explained. I'll check once CI runs.
  • F-Droid CI runners are under GitLab's FOSS program, so there's no need for you to pay for any CI time. If Gitlab starts asking for phone numbers or credit cards don't submit anything, just leave a note in the MR so we know we need to trigger the CI.

Local checks

  • fdroid lint: no problems. fdroid rewritemeta: the metadata is already in canonical form.
  • fdroid checkupdates: the tag check finds v1.1.8 and reads version 1.1.8 (10108) through UpdateCheckData.
  • fdroid scanner on the upstream v1.1.8 source (8db4221), with SUSS signatures: 0 problems.
  • Building the same code from source before the version bump: an unsigned assembleRelease with no keystore produced com.hermeswebui.android.fdroid, and fdroid scanner found 0 problems in that APK.
  • I didn't run a full fdroid build on F-Droid's build server. The app needs compileSdk 37, AGP 9.4.1, and Gradle 9.6.0.

Merge request reports

Loading
Loading