Skip to content

Folder Memory

By Fu-Jie ¡ v0.1.0 ⭐ Star this repo
followers points top contributions downloads saves views

Folder Memory is an intelligent context filter plugin for OpenWebUI. It automatically extracts consistent "Project Rules" from ongoing conversations within a folder and injects them back into the folder's system prompt.

Install with Batch Install Plugins

If you already use Batch Install Plugins from GitHub, you can install or update this plugin with:

Install plugin from Fu-Jie/openwebui-extensions

When the selection dialog opens, search for this plugin, check it, and continue.

[!IMPORTANT] If the official OpenWebUI Community version is already installed, remove it first. After that, Batch Install Plugins can keep this plugin updated in future runs.

đŸ”Ĩ What's New in v0.1.0

  • Initial Release: Automated "Project Rules" management for OpenWebUI folders.
  • Folder-Level Persistence: Automatically updates folder system prompts with extracted rules.
  • Optimized Performance: Runs asynchronously and supports PRIORITY configuration for seamless integration with other filters.

✨ Core Features

  • Automatic Extraction: Analyzes chat history every N messages to extract project rules.
  • Non-destructive Injection: Updates only the specific "Project Rules" block in the system prompt, preserving other instructions.
  • Async Processing: Runs in the background without blocking the user's chat experience.
  • ORM Integration: Directly updates folder data using OpenWebUI's internal models for reliability.

Installation & Configuration

1) Installation

  1. Copy folder_memory.py to your OpenWebUI plugins/filters/ directory (or upload via Admin UI).
  2. Enable the filter in your Settings -> Filters.
  3. Prerequisite: Conversations must occur inside a folder (create a folder and start a chat within it).

2) Configuration (Valves)

Valve Default Description
PRIORITY 20 Priority level for the filter operations.
MESSAGE_TRIGGER_COUNT 10 The number of messages required to trigger a rule analysis.
MODEL_ID "" The model used to generate rules. If empty, uses the current chat model.
RULES_BLOCK_TITLE ## 📂 Project Rules The title displayed above the injected rules block.
SHOW_DEBUG_LOG False Show detailed debug logs in the browser console.
UPDATE_ROOT_FOLDER False If enabled, finds and updates the root folder rules instead of the current subfolder.

⭐ Support

If this plugin has been useful, a star on OpenWebUI Extensions is a big motivation for me. Thank you for the support.

🛠ī¸ How It Works

Folder Memory Demo

  1. Trigger: When a conversation reaches MESSAGE_TRIGGER_COUNT (e.g., 10, 20 messages).
  2. Analysis: The plugin sends the recent conversation + existing rules to the LLM.
  3. Synthesis: The LLM merges new insights with old rules, removing obsolete ones.
  4. Update: The new rule set replaces the <!-- OWUI_PROJECT_RULES_START --> block in the folder's system prompt.

⚠ī¸ Notes

  • This plugin modifies the system_prompt of your folders.
  • It uses a specific marker <!-- OWUI_PROJECT_RULES_START --> to locate its content. Do not manually remove these markers if you want the plugin to continue managing that section.

đŸ—ēī¸ Roadmap

See ROADMAP.md for future plans, including "Project Knowledge" collection.

Changelog

See the full history on GitHub: OpenWebUI Extensions