Developer Guide

1. What this guide is

2. Environment & paths

Set these before training or eval:

export WAN_BASE_MODEL=/path/to/Wan2.1-T2V-1.3B
export DATASET_BASE_PATH=data/Context-as-Memory-Dataset
export PYTHONPATH=$PWD:${PYTHONPATH:-}
export OUTPUT_BASE_ROOT=$PWD/outputs

3. Code map

4. Common workflows

Train one memory row (from repo root):

bash train/memory_baselines_basic/run_spatial_memory_baseline.sh
bash train/context_learning/run_pre_qkv_ctx20.sh

Smoke eval with a HF checkpoint:

huggingface-cli download Echo-Team/Echo-Memory \
  spatial_mem/epoch-0.safetensors --local-dir ./ckpts
export CKPT=./ckpts/spatial_mem/epoch-0.safetensors
bash eval/v2/run_static_consistency_loop_and_revisit.sh

6. Site & release (maintainers)

bash scripts/publish_gh_pages.sh

7. Checklist

• Smoke eval with one HF checkpoint before tagging a release.
• Public docs use Echo pool names — no internal paths or benchmark codenames.