explaingit

asimons81/hermes-dreaming

Analysis updated 2026-05-18

40PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A tool that lets an AI system propose updates to its own memory and skills, but only applies them after a human reviews and approves.

Mindmap

mindmap
  root((Hermes Dreaming))
    What it does
      Stages memory updates
      Requires human approval
      Keeps an audit trail
    Tech stack
      Python
      CLI
      Hermes plugin
    Use cases
      Review AI memory changes
      Nightly cron review
      Offline demo testing
    Audience
      AI agent builders
      Hermes plugin users

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

Let an AI agent draft memory or skill updates without letting it write to live state directly.

USE CASE 2

Review and approve or reject proposed changes to an agent's stored facts before they take effect.

USE CASE 3

Schedule a nightly dry-run review of an agent's proposed self-updates via cron.

USE CASE 4

Try the staged review workflow offline using a quickstart demo, with no API key needed.

What is it built with?

PythonCLIHermes plugin

How does it compare?

asimons81/hermes-dreamingbaskduf/harness-starter-kitcortex-ai-quant/crypto-arbitrage-bot-automated-trading
Stars404040
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Optional LLM provider install needed for live model use, the offline quickstart demo works without any API key.

In plain English

Hermes Dreaming is a tool that lets an AI system propose updates to its own memory, stored facts, user preferences, and skills, but holds those proposals in a waiting area for a human to review before anything actually changes. Think of it as a suggestion box with a lock: the AI can write ideas for how to update itself, but nothing gets applied until you explicitly say so. The core loop has three steps. First, you run a "create" or "review" command that points the tool at some source material, such as recent conversation logs or notes. The tool reads those sources and drafts a set of proposed changes, saving them to an artifact directory as plain files you can inspect. Second, you open those files and go through the proposals: approve the ones that look right, reject the ones that do not, and leave notes about why. Third, you run an "apply" command, which writes only the approved changes to the live memory state and backs up what it replaced. This staged approach is the point of the project. AI memory systems that update themselves automatically carry the risk of slowly drifting in unintended directions. By requiring an explicit review and apply step, this tool keeps a human in the loop for every change. Rejected proposals are archived, not deleted, so you have a full audit trail of what was considered and why it was turned down. The tool ships as both a standalone Python command-line program and as a plugin for Hermes, an AI memory management system. A cron job installer lets you schedule nightly dry-run reviews that stage proposals automatically but never apply them without your approval. An offline quickstart demo shows the full flow without requiring an API key or an external AI model. The project is open source under a standard license and includes safety documentation explaining what the tool can and cannot modify.

Copy-paste prompts

Prompt 1
Walk me through installing Hermes Dreaming as a Hermes plugin and running my first staged review.
Prompt 2
Explain what the apply and discard commands do differently in Hermes Dreaming's workflow.
Prompt 3
Show me how to use the offline quickstart demo to test Hermes Dreaming without an API key.
Prompt 4
Help me set up a nightly cron job for review-only checks with Hermes Dreaming.
Prompt 5
What happens to a rejected proposal in Hermes Dreaming, and can I see why it was turned down?

Frequently asked questions

What is hermes-dreaming?

A tool that lets an AI system propose updates to its own memory and skills, but only applies them after a human reviews and approves.

What language is hermes-dreaming written in?

Mainly Python. The stack also includes Python, CLI, Hermes plugin.

How hard is hermes-dreaming to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hermes-dreaming for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.