Skip to content

docs(longmemeval): clarify script selection and document messages_use config#72

Open
FBISiri wants to merge 1 commit into
zjunlp:mainfrom
FBISiri:fix/longmemeval-readme-script-clarification
Open

docs(longmemeval): clarify script selection and document messages_use config#72
FBISiri wants to merge 1 commit into
zjunlp:mainfrom
FBISiri:fix/longmemeval-readme-script-clarification

Conversation

@FBISiri

@FBISiri FBISiri commented Jul 6, 2026

Copy link
Copy Markdown

Summary

Fixes two documentation gaps in experiments/longmemeval/readme.md.

1. Missing run_lightmem_qwen.py in Quick Start

The experiments/longmemeval/readme.md Quick Start (Step 3) only listed:

python run_lightmem_gpt.py

However, the root README.md Quick Start recommends:

cd experiments
python run_lightmem_qwen.py

Both scripts exist and both implement the same LongMemEval evaluation pipeline — the only difference is which LLM provider they're configured for. Users following the longmemeval readme were unaware that a Qwen/DeepSeek-compatible alternative existed, causing confusion when the root README pointed to a different script.

Fix: Step 3 now lists both scripts with clear provider labels, and notes that the root README.md uses run_lightmem_qwen.py as its default example.

2. Undocumented messages_use configuration option (closes #70)

Both evaluation scripts hard-code "messages_use": "user_only" in their configuration block. The paper (Section 3.2) describes memory entries as containing {user_i, model_i} pairs, which led to the question in issue #70: which setting was actually used for the reported LongMemEval results in Table 2?

Fix: Added a Key Configuration Parameters section documenting all three values:

Value Behavior
"user_only" Index only user messages (default; used for Table 2 results)
"assistant_only" Index only assistant messages
"hybrid" Index both user and assistant messages per turn

A short note clarifies the apparent discrepancy between the paper's description and the script default.

Type of change

  • Documentation improvement

Checklist

  • No notebook or code changes
  • No API keys or secrets introduced
  • Verified both run_lightmem_gpt.py and run_lightmem_qwen.py exist in the directory and both use messages_use: "user_only"

… config

The longmemeval readme only listed run_lightmem_gpt.py in Quick Start
while the root README's Quick Start recommends run_lightmem_qwen.py.
First-time users following different entry points ran different scripts
without realising both exist and serve different provider backends.

Changes:
- Quick Start Step 3: list both scripts with clear provider labels
  (GPT-compatible vs Qwen/DeepSeek/compatible), and note that the root
  README's default example is run_lightmem_qwen.py
- Add 'Key Configuration Parameters' section documenting the
  messages_use option (user_only / assistant_only / hybrid), including
  a note clarifying that Table 2 results used 'user_only' -- directly
  addressing the question raised in issue zjunlp#70

Closes zjunlp#70
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarification on LongMemEval evaluation setting

1 participant