ClaraShafiq GitHub avatar

MemoryConstellations

ClaraShafiq

A self-organizing memory system for AI companions that automatically extracts facts from chat, groups them into topics, merges them into narrative episodes, and retrieves context during conversations.

Stars

124

7-day growth

No data

Forks

23

Open issues

1

License

MIT

Last updated

2026-07-26

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It uniquely combines automatic fact extraction, topic grouping, narrative merging, and a visual star map—all designed for persistent AI companion personalities—and is fully open source under MIT license.

Who it is for

  • Developers building AI companions with persistent memory
  • Hobbyists running personal AI chatbots with personality prompts
  • Open-source contributors interested in memory architectures
  • Users who are comfortable with JSON config files and LLM API keys

Use cases

  • Giving AI chatbots long-term, evolving memory of past conversations
  • Integrating memory with an emotional state engine for more dynamic companions
  • Building a personal AI assistant that remembers user preferences and life events
  • Creating interactive storytelling agents with narrative arcs that unfold over time

Strengths

  • Fully automated pipeline (Extract → Organize → Retrieve) with minimal manual curation needed
  • Hybrid retrieval combining keyword (FTS5), vector similarity (ChromaDB), and entity aggregation via RRF fusion
  • Multiple memory layers (fragments, episodes, sagas) with automatic lifecycle management and decay
  • Companion tools (recall, browse, manage state, correct) allow direct memory interaction without extra coding

Considerations

  • The star map visualization is desktop-only (mobile support not yet implemented)
  • Requires an LLM API key and approximately $7/month for the memory pipeline (excluding chat model costs)
  • Not designed for general-purpose RAG on documents; sagas are experimental and not yet used in production

README quick start

Quick Start

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234