vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-05-23 21:06:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
agent-zero/plugins/_memory
History
Alessandro d1827e6c66
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Details
Build And Publish Docker Images / build (push) Blocked by required conditions
Details
Refactor: use user locale for time displays 
Add user-configurable timezone and 12/24-hour preferences, then wire them through settings, runtime snapshots, scheduler payloads, wait handling, notifications, backups, memory, plugin metadata, and frontend formatters.

Keep UTC as the boundary for absolute instants while serializing user-facing dates in the configured or browser-resolved timezone. Preserve scheduler wall-clock inputs in the selected timezone, propagate TZ into desktop/runtime process environments, and restart active desktop sessions when the runtime timezone changes.

Cover the risky paths with timezone regression tests for settings normalization, auto and fixed timezone resolution, scheduler round-trips, memory timestamp conversion, and desktop timezone sync.
2026-05-21 15:26:00 +02:00
..
api Refactor: use user locale for time displays 2026-05-21 15:26:00 +02:00
extensions memory: harden FAISS integrity and consolidation scoring 2026-04-08 14:02:05 +02:00
helpers Refactor: use user locale for time displays 2026-05-21 15:26:00 +02:00
prompts fix: make memory cleanup update stale fragments 2026-05-11 11:51:58 +02:00
tools fix: make memory cleanup update stale fragments 2026-05-11 11:51:58 +02:00
webui Refactor: use user locale for time displays 2026-05-21 15:26:00 +02:00
default_config.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
plugin.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
README.md refactor: normalize plugin paths, add README viewer to plugin info modal, and update plugin hub filters 2026-03-22 08:05:32 +01:00

README.md

Memory

Provide persistent vector-based memory and knowledge retrieval for Agent Zero.

What It Does

This plugin stores memories and knowledge embeddings in a FAISS-backed vector database, exposes tools for saving and recalling memories, and provides APIs and UI support for browsing, importing, updating, and deleting memory entries.

Main Behavior

  • Persistent vector store
    • Creates and loads FAISS indexes per memory subdirectory.
    • Stores embedding metadata so the index can be rebuilt if the embedding model changes.
  • Knowledge preloading
    • Loads configured knowledge directories into memory when a database is initialized.
  • Memory tools
    • Includes tools for saving, loading, deleting, forgetting, and behavior adjustment workflows.
  • Dashboard APIs
    • Exposes search, delete, bulk delete, update, and subdirectory listing endpoints for the memory dashboard.
  • Scoped storage
    • Supports different memory subdirectories so memory can be separated by context or agent scope.

Key Files

  • Core memory engine
    • helpers/memory.py implements FAISS storage, index loading, embedding configuration, and knowledge preload.
  • Knowledge import
    • helpers/knowledge_import.py imports external knowledge into memory storage.
  • Consolidation
    • helpers/memory_consolidation.py contains memory consolidation logic.
  • Tools
    • tools/memory_save.py
    • tools/memory_load.py
    • tools/memory_delete.py
    • tools/memory_forget.py
    • tools/behaviour_adjustment.py
  • API
    • api/memory_dashboard.py powers the memory management dashboard.
    • api/import_knowledge.py and api/knowledge_reindex.py handle knowledge import and reindexing.

Configuration Scope

  • Settings section: agent
  • Per-project config: true
  • Per-agent config: true

Plugin Metadata

  • Name: _memory
  • Title: Memory
  • Description: Provides persistent memory capabilities to Agent Zero agents.