User guide

Memory and people

What Pimpo remembers, and sharing it with the people of the house.

Memory#

Pimpo remembers what you tell it. Facts it read somewhere are marked "not confirmed" and never guide it until you confirm them. Every change is versioned: History › Go back to this undoes any change.

Each fact shows where it came from: a conversation, a task, a routine or a job (a link opens it), an email and its sender, an import, something you typed, or a preference Pimpo learned. Facts saved before Pimpo kept sources say "Unknown source". Sources groups your facts by where they came from; Delete everything from this source lists the facts that go and, once you confirm, deletes them all, for example everything read in emails from one sender or noted in one conversation. A fact found in two places goes with either. It is one change in History, so it can be undone. You see and delete only your own facts' sources, and of the household's facts only the ones you shared.

Search memory in plain words ("what can't I eat?"): with Jev set up, Pimpo finds facts by meaning, not only by the words they share, and the agent uses the same search. Every night Pimpo merges facts that say the same thing, never trading one you confirmed for one it read somewhere, and never merging facts that differ in a date, place or name. Organize does it now, and History undoes it.

Preferences Pimpo learns#

Once a week Pimpo looks at what you asked and decided yourself (the requests you made, the approvals you denied or made permanent, the suggestions you took or declined) and may note up to five preferences, such as "answers in Portuguese" or "nothing before 8". It never learns from an email, a page or anything else it read. Each one shows up in Memory marked learned, with what showed it: Confirm makes it a fact like any other, and removing it means it is not learned again. Turn it off in Settings › Notifications. Each one is also a lesson in Lessons.

Lessons#

Lessons (with a count in the menu, and a line in Needs you) is where everything Pimpo noticed and would keep waits for you, and only for you: nobody else in the house, the administrator included, sees your lessons. There are four kinds:

• Preference: one it learned from your own requests (above), with links to the requests it came from.
• Fact: a note the agent took during a task ("your boss is Carlos"), with a link to that task. It may have read it in an email, so it counts as unconfirmed until you accept it.
• Routine: a task you asked more than once that worked and is not a routine yet, or a suggestion (below). It shows the request the routine would do and links to each time you asked.
• Fix: a routine failed and the agent redid it (Redo with the agent). It shows the error and what the new version did.

Accept does what you would do by hand: it confirms the fact or preference, or turns the task into a routine (or keeps the repaired version) through the usual compiler, with its checks, so an older version stays in the routine's history. Edit lets you change the words first: the fact is kept in your words, and a routine or fix with new words is done once more for you to watch and approve. Reject removes the note or discards the repair, and the same lesson is never proposed again, even worded a little differently. Nothing on this page applies until you choose, and the Memory page and Needs you show the same things, so deciding in either place counts. Once a week, if lessons are waiting, Pimpo tells you on your channel with a link (turn it off in Settings › Notifications › Weekly lessons digest); you decide on the page, never by replying.

People#

In People, invite family members as a member or a guest. They send the invite code to the bot and get their own memory and accounts. To give someone the app, pair a device for them in Settings › Open on your phone (choose whose device it is): it signs in as them.

Everything is private to its person: routines, conversations, memory, activity, approvals, recordings, long jobs and what their phone shares. Nobody sees anyone else's, and that includes you, the owner: you run the house (people, connections, models, rules, backups) but never see what the others keep. Only costs are shared, as a total, because the budget is the house's. A fact marked Household in Memory is shared with everyone.

Signing in. Besides the link, each person can add a passkey in Account (the menu under your name): afterwards Pimpo opens with Touch ID, Face ID, Windows Hello or a security key, as them. A passkey works at the address where it was made, localhost on the computer or an https address; on the home-network address, and in the desktop app's own window, use the link (Pimpo offers a passkey only where one can work). Sessions and devices left unused expire (30 and 180 days).

A member manages their own routines and answers their own approvals; a guest can only ask, and a guest's changes wait for the person responsible for them. A lasting "always allow" is a rule for the whole house, so only the owner makes those. Removing a person revokes their devices at once.

Models and spending. Under each person, Models and spending chooses which of the house's models they may use (all of them, or some) and a daily limit of their own, in dollars, at most the house's. A guest starts with $0.25 a day until you set another. Every cost counts for the person it was for, whether it came from a chat, a routine, a job or a judgment, and a call is refused when it could pass their limit or the house's. The automatic choice picks only among their models (the cheapest of them when its own pick is not allowed), a model chosen by hand outside them is refused with the reason, and their routines and jobs keep to them too. You see only whether someone reached their limit today, never how much they spent: costs are shared as a house total. Each person sees their own models, limit and today's spending in Account.

This page is built from the repository's documentation. Improve it on GitHub.