Zing Forum

Reading

Hermes Agent Workflow: A Complete Solution for Building a Private Personal AI Assistant

Hermes Agent Workflow is an open-source template project that provides a complete solution for deploying a full AI assistant stack on personal hardware, including agent runtime, PWA frontend, audio bridging, local memory backend, and systemd service management.

AIagentPWA私有化开源hermessidekickhindsightsystemdgit-crypt
Published 2026-05-10 19:45Recent activity 2026-05-10 19:52Estimated read 4 min
Hermes Agent Workflow: A Complete Solution for Building a Private Personal AI Assistant
1

Section 01

Introduction / Main Post: Hermes Agent Workflow: A Complete Solution for Building a Private Personal AI Assistant

Hermes Agent Workflow is an open-source template project that provides a complete solution for deploying a full AI assistant stack on personal hardware, including agent runtime, PWA frontend, audio bridging, local memory backend, and systemd service management.

2

Section 02

Project Overview and Positioning

In the current AI assistant field, most users' choices are limited to commercial cloud services (e.g., ChatGPT, Claude) or closed hardware products. For users who want a truly private and customizable AI assistant, there is a lack of a complete, implementable open-source solution.

Hermes Agent Workflow is an open-source project born to fill this gap. It provides a public template that allows users to deploy a full personal AI assistant stack on their own hardware, including components like agent runtime, progressive web application (PWA) frontend, audio bridging, local memory backend, etc.

The project positions itself as "early but usable, with clear opinions but not a polished product", meaning it offers a well-thought-out architecture while retaining sufficient flexibility for users to customize.

3

Section 03

Core Component Architecture

Hermes Agent Workflow uses a layered architecture with clear responsibilities for each component:

4

Section 04

1. hermes-agent (Core Runtime)

Based on the hermes-agent Python package from Nous Research, it provides:

  • Agent main loop and skill system
  • Gateway service
  • Plugin mechanism
  • Cron task scheduling
5

Section 05

2. sidekick (PWA Frontend)

An independent progressive web application (PWA) that includes:

  • Bun proxy server
  • Python audio bridge (based on aiortc)
  • Low-latency voice input/output via WebRTC
  • Integration with Deepgram for speech recognition

Sidekick is located in a separate repository, and this template is responsible for connecting it with backend components.

6

Section 06

3. hindsight (Local Memory Backend)

A small server based on Postgres database and FastAPI, providing retrievable memory storage for hermes-agent. This is a key component for achieving a long-term personalized AI experience.

7

Section 07

4. systemd User Units

Provides system service management for the gateway, hindsight server, sidekick proxy, and audio bridge, ensuring all components run stably as background services.

8

Section 08

5. Auxiliary Scripts

  • doctor script: Health check and symbolic link integrity verification
  • sync script: Optional cron-driven backup that backs up agent state to the user's fork