git404hub

what is fnos-hermes-agent fr?

iranee/fnos-hermes-agent — explained in plain English

Analysis updated 2026-05-18

24HTMLAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

tl;dr

An AI assistant app built specifically for fnOS NAS devices, installed as a native app with a web control panel for chatting with multiple AI providers.

vibe map

mindmap
  root((Hermes Agent))
    What it does
      AI chat assistant
      Runs natively on fnOS
      Web control panel
    Tech stack
      Bun
      Python
      uv package manager
    Use cases
      Self hosted AI chat
      Connect to WeChat Telegram
      Analyze uploaded files
    Audience
      NAS owners
      Self hosters
    Setup
      fnOS app center
      Model API key
      About 1 GB storage

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a personal AI chat assistant directly on your fnOS NAS with no external server needed.

VIBE 2

Connect the assistant to messaging apps like WeChat, Telegram, Discord, or Slack so you can chat with it from your phone.

VIBE 3

Send images and files to the assistant for analysis without leaving the NAS.

what's the stack?

BunPythonuvJavaScript

how it stacks up fr

iranee/fnos-hermes-agentddekadt/my580_agentic_aidrobiazkin/ai-agent-architecture
Stars242424
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyeasy
Complexity3/51/53/5
Audienceops devopsresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an fnOS NAS device and an API key from a supported model provider.

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Hermes Agent for fnOS is an AI assistant app built specifically to run on fnOS, a NAS (network storage) operating system made by a company called Feiniu. It installs as a native app through fnOS's own app center, using a package format called fpk, so you do not need to set up a separate server or open extra network ports yourself. Once installed, you manage and chat with the assistant through a web based control panel. In that panel you pick which AI model provider to use, options include OpenRouter, OpenAI, Anthropic, Kimi, and MiniMax, and enter an API key for that provider. The chat interface supports full Markdown formatting, lets you upload images and files for the assistant to look at, and remembers context across separate conversation sessions. It can also turn a web link into a QR code so you can open it quickly on a phone. Beyond the web chat, the agent can connect to outside messaging apps such as WeChat, Telegram, Discord, Slack, QQ, DingTalk, and Feishu, so you can talk to it from those platforms too. Behind the scenes, a small program called Monitor, built with the Bun JavaScript runtime, manages the whole system. It talks to the web control panel over a local Unix socket and forwards chat requests to a separate Hermes Gateway process, which is the part that actually calls the AI model providers. The assistant itself runs in a Python environment managed by a tool called uv, with its packages typically downloaded from an Alibaba Cloud mirror and falling back to GitHub if needed. A randomly generated token is created each time the app starts, and any action that changes settings or restarts a process must include that token, while simply viewing status or logs does not require it. The app needs about 1 gigabyte of free storage, and its data, including configuration files, chat history, and downloaded skills, is stored on the NAS itself so it persists across restarts and updates. Updates are checked from the control panel and can be installed with one click. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Explain how to install this Hermes Agent .fpk package on my fnOS NAS.
prompt 2
Walk me through configuring the model provider and API key in the control panel.
prompt 3
Show me how to connect this agent to Telegram or Discord as a messaging gateway.
prompt 4
Explain the difference between the Monitor service, the Gateway, and the dashboard in this app's architecture.

Frequently asked questions

what is fnos-hermes-agent fr?

An AI assistant app built specifically for fnOS NAS devices, installed as a native app with a web control panel for chatting with multiple AI providers.

What language is fnos-hermes-agent written in?

Mainly HTML. The stack also includes Bun, Python, uv.

What license does fnos-hermes-agent use?

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is fnos-hermes-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fnos-hermes-agent for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.