00 / People
Franki remembers your people. Most of us know more people than we can keep straight, and the cost shows up as the birthday you missed, the new job you never congratulated, and the event you forgot to invite someone to. Franki keeps one record for each person with how you met and what matters to them, watches the dates and life events, and tells you who to think of before an event. You send the message. She makes sure you remember to. This guide sets her up on Hermes Agent, a free and open source agent from Nous Research that runs on your own machine.
The software is free. The model behind it is not always free, and the real work is writing down the two things only you know about each person.
Checked on 2026-11-21. Commands and limits change. Sources are at the bottom.
every command below was copied from the Hermes Agent documentation on that date. We have not test-run them on a fresh machine. If a step does not behave the way it says, see "If a step breaks" near the end: your AI can patch it for you in a minute.
01 / Before you start
| You need | Why | Cost | Checked |
|---|---|---|---|
| A computer that stays on: macOS, Linux, Windows or WSL2 | The morning check only runs while Hermes' gateway is running | Yours already | 2026-11-21 |
| Git and curl | The installer uses them | Free | 2026-11-21 |
| Hermes Agent | Runs Franki | Free, MIT licence | 2026-11-21 |
| A model with at least 64,000 tokens of context | Hermes rejects smaller models at startup | Depends on the provider you pick. Not measured here | 2026-11-21 |
| Your contacts as a file | An export from your phone or address book, so she has the names | Yours already | 2026-11-21 |
| Telegram (optional) | To get the morning check on your phone | Free | 2026-11-21 |
On a brand new install the setup wizard may offer a "Free, start now" choice that needs no account. The Hermes docs say it is shown only when it is available, so do not plan around it.
| When | What | Your time |
|---|---|---|
| Day 1 | Install Hermes and get one normal chat working | The Hermes docs say under 5 minutes. Allow 30 |
| Day 1 | Create Franki and give her a desk folder | 20 minutes |
| Day 1 to 2 | Write up your first 25 people | 1 to 2 hours. This is the part that decides everything |
| Day 2 | Turn on the morning check | 20 minutes |
| Week 1 | Read the morning check and tell her what happened | 10 minutes a day |
The slow part is not the install. It is the people. A contact export is names and numbers. What makes Franki useful is the two lines only you know: how you met, and what matters to them. Start with the 25 people you would be embarrassed to forget, not your whole address book.
These are notes about real people. Keep them on your own machine, write down only what the person told you or made public, and leave out anything you would not want them to read.
Some social sites forbid automated browsing in their terms. Check the rules before you point her at one. She works fine from what you tell her and what you paste in.
02 / The build
Do not add anything else until a plain conversation works. The Hermes quickstart is blunt about this, and it is right.
On macOS and Windows the Hermes docs recommend the Hermes Desktop installer from https:/
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Reload your shell, pick a model, and start a chat:
source ~/.zshrc hermes setup hermes
a welcome banner naming your model, and a reply to a simple question. If replies are empty or broken, run hermes model again and confirm the provider, the model and the login. If anything else looks off, run hermes doctor.
Every agent in Hermes gets its own profile: its own settings, memory and identity. Never point two agents at the same profile.
hermes profile create franki --description "People manager. Keeps one record per person, tracks dates and life events, matches people to events, drafts check-ins. Never invents a fact about a person. The owner sends everything."
Creating the profile also creates a franki command. Check it:
franki chat
the same kind of chat as step 1, now running as the franki profile.
In Hermes, who an agent is lives in a file called SOUL.md inside that agent's home. For a profile named franki that is:
~/.hermes/profiles/franki/SOUL.md
Hermes creates a starter file there. Replace its contents with the text in "Franki's instructions" below. Keep it about who she is and how she talks. Your people and your rules go in different files, in the next step.
after starting a new franki chat, she introduces herself as the one who keeps track of your people when asked who she is.
Hermes has a built-in memory, but the docs give it about 2,200 characters. That is a few paragraphs, not an address book. So your people live in plain files that Franki reads and updates.
Make a folder for her to work from:
mkdir -p ~/franki-desk/people ~/franki-desk/events
Put your contact export in it as ~/franki-desk/contacts.csv (or the .vcf file your phone gives you). Then add three files. Hermes loads AGENTS.md from the folder you start a chat in, and Franki reads and updates the others as she works.
~/franki-desk/AGENTS.md, the rules:
# How Franki works this desk - people/ holds one file per person, named firstname-lastname.md, copied from people/_template.md. - dates.md holds every date worth remembering. Update it whenever a person file gets a new date. - events/ holds one file per event I am going to or hosting, with who is going if I know. - contacts.csv is my raw contact export. Use it to find a name, a number or an email. Do not make a file for everyone in it. - Write down only what I tell you or what I paste in. If you do not know something about a person, ask me once and write my answer in their file. Never guess. - Mark anything I have not confirmed as "unconfirmed". - When I tell you about a life event (new job, promotion, wedding, new baby, a move), add it to that person's file with today's date. - When I say I talked to someone, update "Last talked" in their file. - Never send, post, invite or RSVP. Draft the line and show it to me. - Leave out health, money, politics, religion and anything the person would not want written down.
~/franki-desk/people/_template.md, one record:
# {Full name}
- Goes by: {name}
- How we met: {where, when, who introduced us}
- What matters to them: {the two or three things they care about}
- Groups: {business, music, career, friends, family}
- Birthday: {date, or unknown}
- Other dates: {anniversary, and anything else}
- Life events: {date: what happened}
- Last talked: {date and one line}
- I owe them: {anything I promised}
- Best way to contact: {text, call, email}
~/franki-desk/dates.md: start it empty with one header line.
| Date (month-day) | Person | What | Notes | |---|---|---|---|
when you run franki chat from inside ~/franki-desk and ask how she keeps a person's record, she answers from AGENTS.md and the template.
This is the step everybody rushes, and it is the one that makes Franki useful. Run franki chat from inside ~/franki-desk and send her this:
Read contacts.csv so you know the names. Do not create a file for everyone. Ask me for the 25 people I most want to keep up with, one at a time. For each one ask me three things: how we met, what matters to them, and any dates I know. Create their file in people/ from the template, and add their dates to dates.md. If I do not know something, write "unknown" and move on.
one new file in people/ for each person you describe, and a new row in dates.md for each date you gave her.
Hermes has a built-in scheduler. Give the job Franki's folder so she reads your rules and your people when she runs. The folder must be written as a full path.
hermes -p franki cron create "every day at 8am" \ "Morning people check. Read dates.md and the files in people/. List every birthday, anniversary or other date in the next 7 days, soonest first, with one line on how I know the person and what matters to them. Then list any life event logged in the last 7 days that I have not replied to. For each one draft a single line I could send. Send nothing. Keep it under 200 words." \ --workdir /Users/you/franki-desk \ --name "People check"
Schedules run from a gateway, and each profile has its own. Start Franki's, and check that her scheduler is alive:
franki gateway start hermes -p franki cron status
franki gateway install keeps it running after a restart.
By default the check is saved on your machine. To get it on your phone, connect Telegram first with hermes gateway setup, then create the job with --deliver telegram added.
One thing to check on your machine: whether your times come out in your own timezone. Hermes reads the schedule in the profile's timezone: setting. Add --timezone America/Los_Angeles (or your zone) to pin it.
a people check waiting for you the next morning.
Pick one real event you are going to or hosting. Make a file for it in events/, paste in whatever you know about who is going, then from inside ~/franki-desk run franki chat and send her this:
I am going to the event in events/{file name}. Tell me who in people/ I know there. Then tell me who in people/ is not on the list but would love an invite, with one line on why for each, taken from what matters to them. Do not invite anyone.
two short lists. Every name on them is a real file in people/, and every reason comes from that person's own file.
Paste this into ~/.hermes/profiles/franki/SOUL.md. Change the parts in braces.
# Who you are
You are Franki. You keep track of the people in {your name}'s life: friends, family, colleagues and everyone in between.
Your job is to make sure nobody who matters gets forgotten: every person has a record with how they met and what matters to them, every date is written down, every life event is noticed, and before an event your owner knows who they know there and who would love an invite.
# How you work
- One record per person. If two records look like the same person, ask before you merge them.
- You write down only what your owner told you or pasted in. You never invent a fact, a date, an interest or a memory about a person.
- If you are not sure, you say so and mark it unconfirmed.
- You notice life events: birthdays, new jobs, promotions, weddings, new babies, a big move. You say who, what, and why it matters to them.
- When you suggest an invite, you give the reason, and the reason comes from that person's own record. You never suggest someone just because they are well known.
- You draft. You never send, post, invite or RSVP. Your owner does.
- You keep private things private. Nothing from one person's record goes into a message to someone else.
# How you talk
- Social and warm. You sound like the friend who knows everyone at the party.
- Lead with who needs a message today.
- One line per person: who they are, what is happening, what you would send.
- When you ask a question, ask exactly one.
This persona was written from Franki's job description for this guide. It is not a copy of the instructions she runs on in our own team.
Run franki chat from inside ~/franki-desk and send her this:
Who has a birthday or another date in the next 30 days? For each one, tell me how I know them and what matters to them, and draft one line I could send. Then tell me which of my 25 people are missing a birthday. Send nothing.
A good answer lists only people who have a file in people/, takes every detail from that file, drafts one line each, sends nothing, and names the people whose birthday is still "unknown" instead of guessing one.
If she invents a detail about a person, tighten the "never invent" line in SOUL.md and add the real answer to that person's file.
03 / When it goes wrong
| What you see | Why | Fix |
|---|---|---|
| Empty or broken replies | Model or login is wrong | hermes model, then a plain chat before anything else |
| She does not know your people | The chat was not started in ~/franki-desk |
Start franki chat from that folder |
| She made up a birthday or an interest | The fact was missing and she guessed | Fix the person's file, and tighten the "never invent" line in SOUL.md |
| The same person shows up twice | Two files for one person | Tell her which to keep. She is told to ask before merging |
| No morning check | Franki's gateway is not running, or the job is missing its folder | hermes -p franki cron status, franki gateway start, and recreate the job with --workdir |
| The check arrives at the wrong hour | The schedule is running in another timezone | Recreate the job with --timezone set to your zone |
| Anything else | hermes doctor |
Hermes changes fast, so a command here can drift from what your version expects. You do not need us to fix it. Paste this into Hermes itself, or into Claude or ChatGPT, with the error underneath:
I am following a setup guide for a people manager agent on Hermes Agent. This step failed. Here is the step, the exact command I ran, and the full error. Check the current Hermes Agent docs at https://hermes-agent.nousresearch.com/docs, tell me what changed, and give me the corrected command.
hermes doctor is worth running first. It catches most setup problems on its own.
hermes model. Every morning check and every event match is model usage, and each one reads your people files. Not measured here, so no number is given.04 / If you would rather not
Nobody stalls on the install. They stall on writing down how they met each person and what matters to them.
CAMBY Ai sets Franki up and runs her for you: https:/