Kwizerana Thesis Hub Latest Archive
Kwizerana
A Kwizerana Field Guide

Installing Hermes, the Kwizerana Way

A plain-language setup guide for Hermes, the open personal AI agent — plus the step most setups skip: proof of what it actually did.

Hermes is a capable, memory-persistent agent. Connect it to your calendar, inbox, and tools, and it starts acting on your behalf. That's the appeal — and the catch.

Once something has that much reach into your day, "trust me" isn't good enough. Below is how we set Hermes up: install, connect, bring it to your phone, and shape it into something useful. Then, in the last step, we show how we'd close the gap with Membrane, our open attestation layer — so every action leaves a record you control, not one buried in someone else's database.

1

Install Hermes

Two ways in, both under a minute. If you'd rather not touch a terminal, get the desktop app at hermes-agent.nousresearch.com — pick your OS, download, open.

Comfortable in a terminal instead? One line, works across Mac, Linux, and Windows:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Either way, you land in the chat interface — your control center for everything after this.

2

Connect your tools

On its own, Hermes can't see your calendar or your inbox. Composio is the bridge — it plugs over a thousand apps into Hermes. Paste this into the chat box and it installs itself:

https://composio.dev/hermes

Then tell Hermes what to connect: calendar, email, task manager, Slack, GitHub — whatever you'd hand a real assistant. Hermes will walk you through authorizing each one.

This is also the step worth slowing down on. You're deciding what Hermes can see. Connect what you'll actually use, not everything at once — you can always add more later.

While you're in settings, turn on persistent memory (so it recalls past conversations instead of starting cold each time) and skill generation (so completed tasks become reusable steps for next time).

3

Bring it to your phone

The desktop app is fine at your desk, but the real unlock is reaching Hermes from anywhere. Pick a messaging platform you already live in — Telegram, WhatsApp, Slack, Signal, or Discord — and link it.

By default, Hermes locks to an allowlist, so it's only ever you (or whoever you explicitly add) who can message it or trigger a task. Once connected, you can fire off a background task from your phone and it'll report back in that same chat when it's done.

Mid-task and changed your mind? Send "/stop" — no need to wait it out.

4

Learn its language

A few starting prompts that pull real weight:

  • Calendar — "What's on my calendar today? Flag any conflicts and tell me if I'm double booked."
  • Tasks — "Pull my task list and tell me what's overdue or due in the next 3 days."
  • Slack — "Check my DMs and unread channels. Summarize anything that actually needs a response from me."

For anything recurring, Hermes has a built-in scheduler — "Every morning at 9, scan my inbox and send me a summary" runs itself from then on.

5

Make it yours

Hermes ships capable but generic. Set a tone with /personality direct for work, or something looser for personal tasks. Swap the underlying model anytime by naming it, or just ask Hermes to switch. Pin a "home" chat with /sethome so there's always one place everything reports back to.

6

Attest it — with Membrane

Here's the part most setups stop short of. Hermes can now read your calendar, draft your email, and touch your task list. Once it's done, that action is invisible again — unless you go looking, and unless you trust what you find.

Membrane, Kwizerana's open attestation layer, is our answer to that gap. Every tool call Hermes makes can be hashed, timestamped, and logged the moment it happens — a receipt you hold, not a claim you take on faith. Here's roughly what that looks like in practice:

09:14:03 hermes.calendar.read attested ✓ a9f3e1…c208 09:14:05 hermes.email.summarize attested ✓ 71e0b4…9ad2 09:41:22 hermes.task.create attested ✓ 3cc98a…104f 14:02:57 hermes.slack.draft_reply attested ✓ e615f0…77b1

A demonstration of what an attested action log looks like — each entry a proof, not a promise.

And here's the same thing from the other side — what you, or anyone you send the link to, would actually open:

🔒  wall.membrane.xyz/hermes-kris
Membrane hermes-kris

Attested actions

✓
hermes.calendar.read
Today, 9:14 AM · a9f3e1…c208
✓
hermes.email.summarize
Today, 9:14 AM · 71e0b4…9ad2
✓
hermes.task.create
Today, 9:41 AM · 3cc98a…104f
Anchored to Avalanche C-Chain · Merkle-verified

A mockup of the hosted proof wall — the page a shared link like this one opens to.

This is our Your-Data-Log ritual applied to an agent instead of an account. Same idea, same reason: nothing is hidden, because nothing needs to be.

For builders — Membrane ships as open-core Python and JS SDKs. Wrapped around Hermes's tool-call layer, it attests before and after each call instead of leaving you to trust a changelog.