Hermes fnOS

What Hermes fnOS does

The repository provides the fpk metadata and lifecycle scripts needed to install, upgrade, configure and uninstall Hermes Agent on fnOS. During installation it creates a Python virtual environment using the Python 3.12 that comes with fnOS, installs hermes-agent from PyPI with pip, and clones nesquena/hermes-webui from GitHub. There is no Docker dependency, and the package itself is only about 30 KB.

Because networks in China often struggle to reach GitHub directly, the install wizard offers a chain of pip mirrors (including Alibaba Cloud, Tsinghua TUNA and USTC) and GitHub proxies, and lets you choose a custom data path such as /vol3/hermes-data. After install, the WebUI is reachable on the NAS address at port 8787. The WebUI and agent can be upgraded online with scripts, while the fpk itself is upgraded by downloading a new release and installing it in the fnOS App Center. A build script, build-hermes-fpk.sh, produces the package.

Key features

• Native fnOS .fpk app with no Docker dependency
• Installs hermes-agent into a Python 3.12 virtual environment
• Bundles Hermes WebUI, served on port 8787
• Install wizard for pip mirror, GitHub proxy and data path
• Online upgrade scripts for the WebUI and the agent
• build-hermes-fpk.sh script to build the package

When to use it

• Running Hermes Agent on an fnOS NAS that stays on around the clock
• Installing on a network where GitHub and PyPI are slow, using the mirror and proxy chains
• Managing the agent from a browser through the bundled WebUI

Who it is for: fnOS NAS owners who want Hermes Agent installed as a regular app from the App Center.

How it fits with Hermes Agent

Hermes fnOS is a deployment wrapper for Hermes Agent and the community Hermes WebUI, with all agent and interface functionality supplied by those upstream projects.

Requirements: An fnOS NAS with its preinstalled Python 3.12, and network access to PyPI and GitHub or to the mirrors and proxies the wizard offers

Note: This repository is only a packaging layer; Hermes Agent and Hermes WebUI are downloaded from their upstream projects at install time.

FAQ