Hermes Agent for fnOS

What Hermes Agent for fnOS does

The package manages the Hermes process through a Node.js-based Monitor service and exposes a web control panel for model and API-key configuration and for chatting with the agent, supporting multiple messaging channels, WeChat, QQ bot, Feishu, WhatsApp and Telegram, each bound by scanning a QR code in the web UI and independently startable or stoppable. Chat supports full markdown rendering, in-page conversion between a URL and a QR code or text, image and file attachments for the agent to analyze, and multiple parallel chat windows with timeout notices.

A model fallback mechanism switches to a backup model automatically if the primary model fails, keeping the service continuous. The application's lifecycle is managed entirely by fnOS itself, exposing status (running, stopped, starting) in the control panel rather than manual start and stop buttons, and the README points to a separate, newer project by another author that adds expert-team selection and more workflow features.

Key features

• Native fnOS fpk package with a web control panel for setup and chat
• QR-code binding for WeChat, QQ bot, Feishu, WhatsApp and Telegram channels
• Automatic fallback to a backup model if the primary model fails
• Multi-window parallel chat with timeout notices and continued background responses
• Lifecycle fully managed by fnOS, with status shown rather than manual controls

When to use it

• Running a Hermes Agent chatbot directly on a feiniu NAS device without a separate server
• Giving a NAS-hosted Hermes agent QR-bound access to WeChat, QQ, Feishu or WhatsApp
• Keeping a NAS-hosted Hermes chat available through automatic model fallback

Who it is for: fnOS NAS owners who want to run Hermes Agent as a native, app-center-managed package with messaging-channel access.

How it fits with Hermes Agent

This package exists specifically to run Hermes Agent on fnOS NAS hardware through the platform's native app center, proxying chat to a local Hermes gateway process.

Requirements: fnOS with its app center, about 1GB of free storage, and Node.js v24 (handled automatically during install)

Note: The author notes a separate, newer project by another maintainer with more features, and states this project may only keep long-term stable versions updated going forward.

FAQ