Mnemosyne OS
New The documentation explains every engine, step by step. docs.mnemosyne-os.io →

MnemoHermes · beta

Your assistant answers to the name you give it.

You name your assistant when you install the app. You message it on Telegram, or you call it by its name in the app. It searches your memory and answers.

Download Mnemosyne OS How to install it ↓

The cockpit

The MnemoHermes cockpit inside Mnemosyne OS: tasks, agents, tools, skills, the memory inbox and the spending caps.

What it is

Your assistant, with an engine under the hood.

When you install Mnemosyne OS, you choose a name for your assistant. By default it is called "Mnemosyne". You can change it in Settings › Profile.

To act, your assistant uses Hermes Agent. It is an autonomous agent published by Nous Research. It has a terminal, a browser and gateways to messaging apps.

MnemoHermes installs this engine for you. You click "Install the assistant". The app downloads a pinned Hermes release, checks its fingerprint and connects your memory to it.

Hermes Agent is built and published by Nous Research, under the MIT licence.

What you do with it

You ask from your phone. The answer comes from your files.

Student

Revising on the bus

What did the lecturer say about the light phase?

Your assistant searches your Courses vault, on your computer. It answers from your notes and the lecturer's PDF.

Business owner

Preparing a meeting in a taxi

Where is product B at? The quarter's figures.

Your assistant reads the product sheets and meeting notes in your vault. You get a summary in a few lines before you walk in.

Creator

Drafting posts from anywhere

A voice note: "an idea for a post about our new recipe".

The voice note is transcribed on your computer. Your assistant rereads your notes on the topic and drafts three versions. You pick one and post it yourself.

At home

A task on your PC

Sort the PDFs in my Downloads folder by month.

Your assistant has a real terminal. Before a risky command, it shows you the command and waits for your approval.

Telegram

Your Telegram bot talks to your computer.

You create a bot with @BotFather, inside Telegram. Give it your assistant's name. You paste its token in the cockpit's Channels tab.

You type, or you send a voice note. The voice note is transcribed on your machine. Your assistant searches your vaults and answers in text, or out loud if you choose.

Your computer has to stay on, with the Hermes gateway running. The cockpit starts and stops it.

  1. Your phone
  2. Telegram
  3. Your assistant, on your PC
  4. Your Mnemosyne OS vaults

Out loud, or typed

Start your sentence with its name.

In the examples below, the assistant is called Irina. Yours answers to the name you gave it.

Open the voice assistant, the orb, and say: "Irina, summarise this week's customer feedback." You can also type the same sentence in the chat.

Before it starts, your assistant shows a card: "Irina will do: summarise this week's customer feedback". You click Approve or Decline.

Then the orb follows the task and tells you out loud how it is going. When it is done, it reads you the result. You say "stop" to stop it.

An image or a document your assistant made opens full size. You choose the vault to keep it in, or you throw it away.

An app command comes first: "Irina, open the calendar" opens the calendar. A sentence without its name stays a conversation, and the orb answers you as usual.

You stay in charge

Your assistant acts. You decide.

  • The card before every taskYou read what your assistant will do, then you approve or decline. For web searches, summaries and images, you can tick "Stop asking". Settings › Commands takes that choice back.
  • ApprovalsBefore a risky command, you see the command, its reason and the time left. You allow it once, for the session, or always.
  • Three presetsFortress, Balanced, or the fully unlocked mode (YOLO). One click sets Hermes and Mnemosyne OS together.
  • The memory inboxEvery note your assistant writes into your vaults arrives signed. You keep it, move it or reject it.
  • A spending capYou set a number of tokens per day. The cockpit's Settings tab shows today's real spend.
⚠ Careful with the fully unlocked mode

In fully unlocked mode (YOLO), Hermes gets its terminal on every channel and stops asking for your approval. This mode is not recommended on a machine that holds important data. The app asks you to confirm twice before turning it on.

Install it

Five steps, about 30 minutes.

  1. 01 Mnemosyne OS 1.7 Download and install version 1.7.0 or later. Choose your assistant's name during setup.
  2. 02 Add MnemoHermes MnemoHub → "Add an external cartridge" → "A repository". Paste the repository address.
  3. 03 Install the assistant In the cockpit, "Install the assistant". About four minutes.
  4. 04 Link Telegram Create a bot with @BotFather. Paste its token in Channels.
  5. 05 Talk to it Message your bot, or start a sentence with its name in the orb or the chat.

The repository address: https://github.com/Mnemosyne-OS/MnemoHermes

Download, free MnemoHermes on GitHub ↗

Questions

What people ask before installing it.

How do I query my memory from my phone?
Install MnemoHermes in Mnemosyne OS, then the assistant from its cockpit. Link a Telegram bot in the Channels tab. You message the bot. Your assistant searches your vaults, on your computer, and answers.
How do I change my assistant's name?
In Settings › Profile. The new name counts from the next sentence, spoken or typed.
I used to say "ask Hermes to …". Does that still work?
Yes. The name Hermes is still accepted next to the name you chose.
Does my computer have to stay on?
Yes. Your assistant and your memory run on your computer. The phone only receives the answers. If the computer is asleep, the bot does not answer.
How much does it cost?
MnemoHermes is free, under the MIT licence. Hermes Agent is free too. The model that does the thinking is paid separately: your own key, a local model, or Mnemosyne OS credits. A task makes several calls to the model, so set a token cap in the cockpit settings.
Can my assistant write my social media posts?
It drafts versions from your notes and sends them to you on Telegram. You pick the right one and post it yourself.
What about other messaging apps?
The cockpit sets up the main Telegram bot. It also shows the other messaging apps configured in Hermes, which you set up in its configuration file.
Can my assistant touch my files?
Yes, it has a real terminal. Before a risky command, it asks for your approval, and the question arrives on your dashboard. The three presets decide which tools it may use. The fully unlocked mode (YOLO) turns these approvals off.
Is this the same project as mnemosyne-hermes?
No. mnemosyne-hermes is a different project, by a different author, that installs inside Hermes. MnemoHermes is a Mnemosyne OS cartridge that drives Hermes from the app.