Awesome AI Agents › Virtual Assistants

taylorsatula/mira-OSS

⭐ 478 Python repository created 2025-10-18

MIRA is an open-source personal assistant whose central design decision is that there is a single conversation that never resets: the interface offers no way to start a new chat, which forces the system to solve persistence rather than sidestep it. Recent turns stay in the context window while they remain relevant; older material is collapsed into summaries written in the first person, on the argument that third-person logs read to the model as records of someone else rather than as its own recollection. Absolute dates replace relative ones so a summary does not become false with the passage of time, and each new summary is written with the previous five in view so the record forms a continuous narrative. If a live conversation grows too large before it collapses naturally, older messages are compressed into a rolling brief while the newest turns are left intact. Memories are scored by a decay formula driven by use-days rather than calendar days, so absence does not erase them, and they survive through access, explicit reference, links to other memories and entities, or genuine temporal relevance. Recall is mostly passive, assembled before the model answers through semantic similarity, entity hubs, graph traversal, filtering and reranking, with an explicit memory tool available when precise control is needed. Longer stable material lives in encrypted domain documents with section version history, sharing and nested sections that the assistant expands and collapses on its own to limit token use. Two auxiliary layers frame each response: a subcortical retrieval pass that resolves references, extracts entities and judges task difficulty before the main model runs, and a Peanut Gallery observer that reviews recent turns asynchronously and can inject short-lived corrective guidance. The stack uses Python, FastAPI, PostgreSQL and a vector store, and targets people who want to self-host a continuous assistant.

https://github.com/taylorsatula/mira-OSS

ai-assistantlong-term-memorymemory-managementragself-hostedpythonfastapipostgresqlvector-databaseanthropic