abboskhonov/hermium

Hermium is a self hosted AI chat dashboard written in TypeScript. It is a port of an existing project called Hermes Web UI, rebuilt with a different set of tools: TanStack Start for the frontend, Hono as the backend server layer, and Bun as the JavaScript runtime. The code lives in a monorepo, a single repository holding multiple packages that work together. The architecture has three layers. Your browser connects to the frontend on port 3000, which talks to a Hono API server on port 8648, which in turn connects to a separate Hermes Gateway on port 8642. Frontend state is managed with Zustand, a lightweight state library. The backend stores data in SQLite using Bun's built in SQLite support, so no separate database library is needed. The interface components come from shadcn/ui. The monorepo has three packages: web, the React frontend using file based routing, api, the Hono server, and shared, common types used by both sides. Running one command starts both servers together for local development. Compared to the original Hermes Web UI, Hermium replaces Vue with React, Koa with Hono, Pinia with Zustand, and Vue Router with a file based TanStack router. The authentication approach stays the same, a token stored in a local file, and the server sent events interception logic used for tracking AI usage carries over and is ready to be wired up. This project is aimed at developers who want to run their own AI chat interface locally instead of depending on a third party hosted service. The README lists a number of features that are planned but not yet built: real time chat streaming over WebSocket, a file browser with local, Docker, and SSH backends, group chat, a terminal endpoint, settings pages for models and providers, and usage analytics charts drawn from a SQLite table.