Generated banner for memor
Generated logo for memor

memor

Memory frameworkOfficial OpenSciLab project

Created by OpenSciLab

Published in openscilab/memor. Publisher page

69 GitHub stars

What it is

Reproducible Structured Memory for LLMs
— the description by OpenSciLab

Summary from the brain’s metadata

Reproducible Structured Memory for LLMs Memor: Reproducible Structured Memory for LLMs

How it works

Memory model: JSON files

AutoGineer overview, from the brain’s own files

Memory model: JSON files. Folders: .github (agent config, 9 files); examples (examples, 8 files); tests (tests, 5 files). The agent reads get_message. The agent writes add_response, update_template, update_message, update_message_from_xml, update_score.

Folders
FolderRoleFiles
.githubagent-config9
examplesexamples8
teststests5
memorfolder12
otherfilesfolder6

The agent reads

The agent writes

Requirements

Runtimes: Python

Set it up

  1. This brain runs code automatically: 1 script. Review setup.py before opening the folder in Claude Code. No step below turns a hook on for you.

    • setup.py: python setup.py
  2. Not scanned by AutoGineerThe author’s README also describes installing it as the PyPI package memor. Read its install section: AutoGineer did not scan that path. https://github.com/openscilab/memor/blob/0f5b66f0806482ddb73b8a33a4d68f19f3280f04/README.md#installation
  3. Created by OpenSciLab. Published in openscilab/memor. Licence: MIT License.

Usage

From the brain’s own files

  • INSTRUCTION1: "*I'm providing you with a history of a previous conversation. Please consider this context when responding to my new question.*"
  • INSTRUCTION2: "*Here is the context from a prior conversation. Please learn from this information and use it to provide a thoughtful and context-aware response to my next questions.*"
  • INSTRUCTION3: "*I am sharing a record of a previous discussion. Use this information to provide a consistent and relevant answer to my next query.*"

Documentation by OpenSciLab

Read the documentation at the source

CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

1.4 - 2026-10-05

Added
  • Z.AI models

  • Moonshot AI models

  • _build_context method

  • FinishReason enum

  • Response class finish_reason property

  • Response class update_finish_reason method

  • Response class seed property

  • Response class update_seed method

  • _validate_int function

Changed
  • Prompt class typing bugs fixed

  • Response class typing bugs fixed

  • Session class typing bugs fixed

  • PromptTemplate class typing bugs fixed

  • OpenAI models updated

  • Google models updated

  • LG-AI models updated

  • Anthropic models updated

  • Meta models updated

  • Qwen models updated

  • _validate_pos_int function renamed to _validate_non_negative_int

  • _validate_pos_float function renamed to _validate_non_negative_float

  • INVALID_POSINT_VALUE_MESSAGE renamed to INVALID_NON_NEGATIVE_INT_VALUE_MESSAGE and message text updated

  • INVALID_POSFLOAT_VALUE_MESSAGE renamed to INVALID_NON_NEGATIVE_FLOAT_VALUE_MESSAGE and message text updated

  • Validation system modified

1.3 - 2026-07-28

Added
  • Session class enable_all_messages method

  • Session class disable_all_messages method

  • PromptTemplate class variables property

  • PromptTemplate class get_missing_variables method

  • PromptTemplate class check_render method

Changed
  • Session class enable_message method modified

  • Session class disable_message method modified

  • Session class mask_message method modified

  • Session class unmask_message method modified

  • Prompt class update_template method modified

  • PromptTemplate class to_dict method modified

  • PromptTemplate class render method modified

  • engine parameter added to from_content_file method

  • Test system modified

  • Response class date bug fixed

1.2 - 2026-06-15

Added
  • TemplateEngine enum

  • MemorError class

  • PromptTemplate class render method

  • PromptTemplate class from_content_file method

  • PromptTemplate class update_engine method

  • PromptTemplate class engine property

  • Prompt class clear_responses method

Changed
  • engine parameter added to PromptTemplate class

  • Prompt class render method updated

  • Prompt class save method updated

  • Response class save method updated

  • LLMModel structure updated

  • LLMModel type changed

  • Session list contamination bug fixed

  • Prompt list contamination bug fixed

  • README.md updated

  • Test system modified

  • Dependencies structure modified

1.1 - 2025-12-23

Added
  • Session class to_dataframe method

  • Session class from_dataframe method

  • Session class reset_render_counter method

  • xml_usage.py example

  • dataframe_usage example

Changed
  • LLMModel enum updated

  • Test system modified

  • README.md updated

1.0 - 2025-11-17

Added
  • Response class xml_tree property

  • Prompt class xml_tree property

  • Response class update_message_from_xml method

  • Prompt class update_message_from_xml method

Changed
  • README.md updated

  • LLMModel enum updated

  • verify parameter added to contains_xml method

  • Warning bug fixed

  • Test system modified

0.9 - 2025-10-22

Added
  • Prompt class contains_xml method

  • Response class contains_xml method

  • Prompt class size warning

  • Response class size warning

  • Session class size warning

  • Response class warnings property

  • Prompt class warnings property

  • Session class warnings property

Changed
  • README.md updated

  • LLMModel enum updated

  • None value update bug fixed

  • show_warning parameter added to render method

  • Python 3.14 added to test.yml

  • Test system modified

  • Typing modified

0.8 - 2025-07-21

Added
  • Logo

  • Response class top_k property

  • Response class top_p property

  • Response class gpu property

Changed
  • AI_STUDIO render format modified

  • LLMModel enum updated

  • Model load bug fixed

  • Test system modified

  • README.md updated

  • _validate_pos_float now validates int values

  • _validate_probability now validates int values

  • None value validation bug fixed

0.7 - 2025-06-25

Added
  • Message abstract class

  • Session class _validate_extract_json method

  • Response class _validate_extract_json method

  • Prompt class _validate_extract_json method

  • PromptTemplate class _validate_extract_json method

  • Session class search method

  • Session class get_size method

  • Response class get_size method

  • Prompt class get_size method

  • PromptTemplate class get_size method

  • Session class size attribute

  • Response class size attribute

  • Prompt class size attribute

  • PromptTemplate class size attribute

  • examples directory

Changed
  • Validation bug fixed in update_messages method in Session class

  • Validation bug fixed in from_json method in PromptTemplate, Response, Prompt, and Session classes

  • AI_STUDIO render format modified

  • Session class messages status bug fixed

  • Test system modified

  • README.md updated

0.6 - 2025-05-05

Added
  • Response class id property

  • Prompt class id property

  • Response class regenerate_id method

  • Prompt class regenerate_id method

  • Session class render_counter method

  • Session class remove_message_by_index and remove_message_by_id methods

  • Session class get_message_by_index, get_message_by_id and get_message methods

  • LLMModel enum

  • AI_STUDIO render format

Changed
  • Test system modified

  • Modification handling centralized via _mark_modified method

  • Session class remove_message method modified

0.5 - 2025-04-16

Added
  • Session class check_render method

  • Session class clear_messages method

  • Prompt class check_render method

  • Session class estimate_tokens method

  • Prompt class estimate_tokens method

  • Response class estimate_tokens method

  • universal_tokens_estimator function

  • openai_tokens_estimator_gpt_3_5 function

  • openai_tokens_estimator_gpt_4 function

Changed
  • init_check parameter added to Prompt class

  • init_check parameter added to Session class

  • Test system modified

  • Python 3.6 support dropped

  • README.md updated

0.4 - 2025-03-17

Added
  • Session class __contains__ method

  • Session class __getitem__ method

  • Session class mask_message method

  • Session class unmask_message method

  • Session class masks attribute

  • Response class __len__ method

  • Prompt class __len__ method

Changed
  • inference_time parameter added to Response class

  • README.md updated

  • Test system modified

  • Python typing features added to all modules

  • Prompt class default values updated

  • Response class default values updated

0.3 - 2025-03-08

Added
  • Session class __len__ method

  • Session class __iter__ method

  • Session class __add__ and __radd__ methods

Changed
  • tokens parameter added to Prompt class

  • tokens parameter added to Response class

  • tokens parameter added to preset templates

  • Prompt class modified

  • Response class modified

  • PromptTemplate class modified

0.2 - 2025-03-01

Added
  • Session class

Changed
  • Prompt class modified

  • Response class modified

  • PromptTemplate class modified

  • README.md updated

  • Test system modified

0.1 - 2025-02-12

Added
  • Prompt class

  • Response class

  • PromptTemplate class

  • PresetPromptTemplate class

56 files · 50 not served here

Advantages

  • Local-first: the memory stays in files or a database on your own machine (a rule-derived fact from the brain’s files, evidence: README.md)
  • No API key is named in its files (a rule-derived fact from the brain’s files, evidence: README.md)
  • Open licence (MIT) (a rule-derived fact from the brain’s files)

Limitations

  • No ZIP download: install it from its source (a rule-derived fact from the brain’s files)

Security

Risk level: Low risk

This brain runs

Install scripts (1)

  • setup.py: python setup.py
  • Low risk: scripts-present (setup.py)

Attribution and licence

Created by
OpenSciLab
Publisher
OpenSciLab (Official OpenSciLab project)
Source
openscilab/memor · commit 0f5b66f
Licence
MIT License (files served here)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by OpenSciLab.

Install from source

50 of its files are not served here, so there is no ZIP. openscilab/memor at 0f5b66f