FeiCai 肥财

中文 | English

Hermes Agent 桌面壳 —— 一个轻量级的跨平台桌面应用，使用系统原生 WebView 承载 Hermes Agent WebUI。

特点

• 轻量：基于 Python + PyWebView，使用系统原生 WebView（macOS 使用 WKWebView，Windows 使用 WebView2）
• 美观界面：基于 Hermes Agent WebUI，优化主题
• SOUL 编辑：内置 SOUL.md 编辑器，随时调整 Agent 人格
• 完整功能：保留 Hermes Agent 所有原生功能页面
• 跨平台：支持 macOS 和 Windows
• 模块化：内置模块加载器（hermes-status、system-info 等），支持自定义扩展

项目结构

feicai/
├── hermes-agent/       # 内置 Hermes Agent 完整代码
├── desktop/            # Python 桌面壳
│   ├── main.py         # 入口文件
│   ├── server.py       # FastAPI 后端服务
│   ├── loader.py       # 模块加载器
│   └── update_checker.py
├── modules/            # 扩展模块
│   ├── hermes-status/
│   └── system-info/
├── scripts/            # 构建脚本
├── requirements.txt    # Python 依赖
└── README.md

快速开始

1. 安装依赖

cd feicai
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. 构建前端

cd hermes-agent/web
npm install
npm run build
cd ../..

3. 启动 Hermes 后端

确保 Hermes Agent 正在运行：

hermes gateway start
# 或者
cd hermes-agent && python -m hermes_cli.main web

4. 启动桌面应用

cd feicai
source venv/bin/activate
python desktop/main.py

开发模式（热重载）

# 终端 1：启动 Vite 开发服务器
cd hermes-agent/web
npm run dev

# 终端 2：启动桌面应用（会自动连到 Vite 服务器）
cd feicai
source venv/bin/activate
python desktop/main.py

打包

macOS (.app)

pip install py2app
python setup.py py2app

Windows (.exe)

pip install pyinstaller
pyinstaller --onefile --windowed desktop/main.py

许可证

本项目基于 Hermes Agent 构建，遵循其原始许可证。

---

FeiCai

English | 中文

A desktop shell for Hermes Agent — a lightweight cross-platform desktop application that hosts the Hermes Agent WebUI inside the system-native WebView.

Features

• Lightweight: Built on Python + PyWebView using the system-native WebView (WKWebView on macOS, WebView2 on Windows)
• Polished UI: Based on the Hermes Agent WebUI with an improved theme
• SOUL Editing: Built-in SOUL.md editor to adjust the agent's persona anytime
• Full Functionality: Keeps all native pages and features of Hermes Agent
• Cross-platform: Supports macOS and Windows
• Modular: Built-in module loader (hermes-status, system-info, etc.) with support for custom extensions

Project Structure

feicai/
├── hermes-agent/       # Bundled Hermes Agent source
├── desktop/            # Python desktop shell
│   ├── main.py         # Entry point
│   ├── server.py       # FastAPI backend service
│   ├── loader.py       # Module loader
│   └── update_checker.py
├── modules/            # Extension modules
│   ├── hermes-status/
│   └── system-info/
├── scripts/            # Build scripts
├── requirements.txt    # Python dependencies
└── README.md

Quick Start

1. Install Dependencies

cd feicai
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Build the Frontend

cd hermes-agent/web
npm install
npm run build
cd ../..

3. Start the Hermes Backend

Make sure Hermes Agent is running:

hermes gateway start
# or
cd hermes-agent && python -m hermes_cli.main web

4. Launch the Desktop App

cd feicai
source venv/bin/activate
python desktop/main.py

Development Mode (Hot Reload)

# Terminal 1: start the Vite dev server
cd hermes-agent/web
npm run dev

# Terminal 2: launch the desktop app (auto-connects to the Vite server)
cd feicai
source venv/bin/activate
python desktop/main.py

Packaging

macOS (.app)

pip install py2app
python setup.py py2app

Windows (.exe)

pip install pyinstaller
pyinstaller --onefile --windowed desktop/main.py

License

This project is built on top of Hermes Agent and follows its original license.