Hermes Mini App Template: app and UI for Hermes Agent

Telegram Mini App template for Hermes Agent with a React frontend and Express backend you fork and extend

What Hermes Mini App Template does

Hermes Mini App Template is a starter project for building a Telegram Mini App for Hermes Agent. The frontend uses React 19, Vite and TypeScript, and a single Express server serves both the API and the built static files, on port 9122 by default. Navigation uses a bottom bar with up to five primary tabs plus an optional More sheet for secondary tabs, and the More button hides itself when no secondary tabs are defined.

Adding a tool means adding a tab entry in src/App.tsx, a page component under src/pages, a case in renderPage(), and an API endpoint in server/index.js. Example pages include a text transform and a JSON formatter, along with Home and Settings pages that have a theme toggle. The README gives deployment recipes for Cloudflare Tunnel, Caddy and Nginx, and explains how to point a bot's menu button at the deployed HTTPS URL through BotFather. All API routes use an /api/ prefix, which matters when Caddy strips the /app prefix.

Key features

React 19, Vite and TypeScript frontend styled with CSS variables
Express server that serves the API and static files from one process
Primary and secondary tab navigation with an automatic More sheet
Example Text Transform and JSON Formatter tools to copy from
Deployment notes for Cloudflare Tunnel, Caddy and Nginx
PORT and CORS_ORIGIN environment variables

When to use it

Starting a Telegram Mini App for a Hermes Agent bot without building the shell from scratch
Adding custom tool pages and matching API endpoints to a ready-made tab layout
Publishing a small web app behind a Cloudflare Tunnel and linking it from a bot's menu button

Who it is for: Developers building a Telegram Mini App for a Hermes Agent bot who are comfortable with TypeScript and Express.

How it fits with Hermes Agent

Presented as a Mini App template for Hermes Agent. The README covers the app shell, server and deployment, and leaves the tool logic to the endpoints you add.

How to install Hermes Mini App Template

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm install
cd server && npm install && cd ..
npm run build
node server/index.js

Requirements: npm, and a deployed HTTPS URL to attach the app to a Telegram bot through BotFather

FAQ

What is Hermes Mini App Template?

Hermes Mini App Template is a fork-and-extend starter for a Telegram Mini App aimed at Hermes Agent users. It combines a React 19 and Vite frontend with an Express backend and example tool pages.

How do I install Hermes Mini App Template?

Clone your fork, run npm install in the root and in the server folder, copy .env.example to .env, then run npm run build and node server/index.js. The app then serves a preview at http://localhost:9122.

Is Hermes Mini App Template free and open source?

The repository has no license file, so default copyright applies. Check with the author before reusing the code.