ufo_memory_manager module

UFO Persistent Memory Management System.

This module manages the AI’s long-term memory, storing personality traits, experiences, relationships, and learned preferences across power cycles.

The memory system provides:

  • Persistent JSON-based memory storage (ufo_memory.json)

  • Personality trait tracking (curiosity, playfulness, calmness, loyalty)

  • Experience accumulation (total interactions, shake count, college displays)

  • Relationship state (trust level, bond strength, last interaction time)

  • Preference learning (favorite colors, modes, times of day)

  • Flash wear protection with controlled save frequency

  • College spirit and team loyalty tracking

Classes:

UFOMemoryManager: Manages persistent AI memory and learning data

Example

>>> memory = UFOMemoryManager(persistent_memory=True)
>>> memory.record_interaction("tap")
>>> memory.update_personality("playfulness", 0.1)
>>> memory.save_memory()  # Persists to ufo_memory.json
Author:

Charles Doebler at Feral Cat AI

Dependencies:

  • Writable filesystem (requires boot.py configuration)

Note

Memory persistence requires filesystem write access. The system gracefully degrades to session-only memory if writes fail. Save frequency is throttled to protect flash memory lifespan.

class ufo_memory_manager.UFOMemoryManager(persistent_memory=False)

Bases: object

cleanup_memory()

Clean up memory when running low.

ensure_memory_structure()

Ensure memory has all required fields with college support - PUBLIC METHOD.

record_college_interaction(interaction_type, success=True)

Record college-related interactions.

record_experience(event_type, data)

Record significant experiences in memory.

record_successful_attention(behavior)

Record successful attention-seeking behavior.

update_memory(curiosity_level, energy_level, environment_baseline)

Update and save long-term memory.