CAMBY Ai
Franki · Setup Guide

00 / People

The software is free.
The people are the work.

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.

How this guide was made:

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.

Franki, who keeps track of people at CAMBY Ai
Franki · Never miss a moment

01 / Before you start

The honest timeline.
The slow part is the people.

What Franki does

  • Keeps one record per person: how you met, what matters to them, and the last time you talked.
  • Keeps every date in one place: birthdays, anniversaries, and anything else worth remembering.
  • Logs life events as you tell her about them: a new job, a promotion, a wedding, a new baby, a big move.
  • Tells you each morning who has something coming up, and drafts one line you could send.
  • Before an event, tells you who you know there and who would love an invite, with a reason for each.
  • Asks when she does not know something about a person. She never invents it.
  • Does not send, post, invite or RSVP. You do.
What you need before you start
You needWhyCostChecked
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.

The honest timeline
WhenWhatYour 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.

Two limits to know before you start:

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

Seven steps.
In this order.

01

Install Hermes and get one chat working

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://hermes-agent.nousresearch.com/. For a command line only install on macOS, Linux or WSL2:

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

Reload your shell, pick a model, and start a chat:

Terminal
source ~/.zshrc
hermes setup
hermes
You should see:

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.

02

Create Franki

Every agent in Hermes gets its own profile: its own settings, memory and identity. Never point two agents at the same profile.

Terminal
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:

Terminal
franki chat
You should see:

the same kind of chat as step 1, now running as the franki profile.

03

Give Franki her identity

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/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.

You should see:

after starting a new franki chat, she introduces herself as the one who keeps track of your people when asked who she is.

04

Build her desk: the rules, the people, the dates

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:

Terminal
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:

~/franki-desk/AGENTS.md
# 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:

~/franki-desk/people/_template.md
# {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.

~/franki-desk/dates.md
| Date (month-day) | Person | What | Notes |
|---|---|---|---|
You should see:

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.

05

Write up your first 25 people

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:

Send to Franki
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.
You should see:

one new file in people/ for each person you describe, and a new row in dates.md for each date you gave her.

06

Schedule the morning check

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.

Terminal
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:

Terminal
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.

You should see:

a people check waiting for you the next morning.

07

Run your first event match, by hand

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:

Send to Franki
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.
You should see:

two short lists. Every name on them is a real file in people/, and every reason comes from that person's own file.

Franki's instructions

Paste this into ~/.hermes/profiles/franki/SOUL.md. Change the parts in braces.

~/.hermes/profiles/franki/SOUL.md
# 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.

First test

Run franki chat from inside ~/franki-desk and send her this:

First test
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

If a step breaks.
You do not need us to fix it.

When it goes wrong
What you seeWhyFix
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

If a step breaks

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:

Prompt
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.

What it costs to run

  • Hermes Agent: free, MIT licence.
  • The model: billed by whichever provider you choose in 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.
  • More people means more to read on every run. That is one more reason to start with 25.

04 / If you would rather not

Want it set up
for you?

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://mikecamby.com

Email
mike@mikecamby.com
Text
747.441.6578
Book a time
cal.com/mikecamby