explaingit

dubnium0/hermes-profile-insights

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 1/5Setup · easy

TLDR

A Python CLI that reads local Hermes AI assistant profile databases and generates terminal reports on usage, model costs, tool activity, and session patterns across multiple profiles.

Mindmap

mindmap
  root((hermes-profile-insights))
    What it reports
      Session and message counts
      Model usage and tokens
      Tool and skill activity
      Activity patterns
      Notable sessions
    Cost reporting
      Stored vs computed cost
      OpenAI and Gemini rates
      Custom price overrides
    How it works
      Reads state.db read-only
      Multi-profile comparison
      CLI or interactive mode
    Audience
      Hermes power users
      Developers
      Cost-conscious teams
Click or tap to explore — scroll the page freely

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 build with it?

USE CASE 1

Run the seven-day cost report for a specific Hermes profile to see how much it spent and which models drove the cost.

USE CASE 2

Use the interactive profile picker to compare session volume and tool usage across all your Hermes profiles at once.

USE CASE 3

Add a prices.json file with custom model rates to get accurate cost estimates for models not included in the built-in pricing table.

What is it built with?

PythonSQLite

How does it compare?

dubnium0/hermes-profile-insightsa-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity1/54/53/5
Audiencedeveloperresearcherdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an existing Hermes installation with profile databases, no external dependencies mentioned beyond Python.

No license specified in the repository.

In plain English

Hermes Insights is a Python script that reads the local data files created by Hermes, an AI assistant platform, and produces terminal reports showing how each profile is being used. If you run Hermes with multiple profiles, such as one for different projects or clients, this tool lets you see what each profile is doing at a glance without opening the databases individually. The reports cover session and message counts, which AI models were used and how many tokens each consumed, which tools and skills were invoked, how active each profile has been over time including peak hours and active day streaks, and which individual sessions stand out as longest or most intensive. A cost report mode shows estimated spending over a configurable number of recent days. Cost figures come from two sources that the tool keeps separate. Stored cost uses whatever cost value Hermes already recorded in the database. Computed cost uses built-in pricing rates for OpenAI and Gemini models to calculate from token counts. You can add a JSON file with custom prices to override the built-in rates or cover models that are not included. The tool opens databases in read-only mode, so it cannot change anything in your Hermes installation. You run it either interactively, where it lets you pick a profile from a menu, or by passing the profile name and a report mode directly on the command line. The design notes in the README emphasize keeping everything local and transparent: no data leaves your machine, the source of each cost number is labeled clearly, and the tool avoids guessing or scoring behavior in ways that are not grounded in the raw numbers. No license is specified in the repository.

Copy-paste prompts

Prompt 1
I use Hermes with multiple profiles. Walk me through running hermes-profile-insights to get a seven-day cost breakdown for my main profile, including how to interpret stored versus computed cost.
Prompt 2
Using the hermes-profile-insights code as a reference, write a Python script that reads the same state.db format and exports a CSV of daily token usage per profile.
Prompt 3
I want to add pricing for a custom model to hermes-profile-insights. Show me the exact JSON format for prices.json and explain which token fields are required.

Frequently asked questions

What is hermes-profile-insights?

A Python CLI that reads local Hermes AI assistant profile databases and generates terminal reports on usage, model costs, tool activity, and session patterns across multiple profiles.

What language is hermes-profile-insights written in?

Mainly Python. The stack also includes Python, SQLite.

What license does hermes-profile-insights use?

No license specified in the repository.

How hard is hermes-profile-insights to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is hermes-profile-insights for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub dubnium0 on gitmyhub

Verify against the repo before relying on details.