Skip to content

Kevin-thu /StoryMem

Give it a shot list, get a minute-long multi-shot video
Model toolingCustom licenseEnglish README
Stars
771
30 days
0
Last push
2 months ago
StoryMem screenshot from its README
From the StoryMem README on GitHub.

About StoryMem

StoryMem makes a minute-long story video, one shot at a time. It builds on Wan2.2 and keeps characters looking the same by saving keyframes as memory. You need a big GPU and large model downloads to run it.

Best for: Researchers and advanced creators who want coherent multi-shot story videos on their own machine.

What it does

  • Generates long story videos shot by shot with a memory model
  • Uses a Memory-to-Video LoRA (a small add-on model) on Wan2.2
  • Keeps characters consistent by saving keyframes after each shot
  • Ships ST-Bench: 30 story scripts with 300 shot prompts
  • Lets you set resolution, seed and memory size from the command line

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Clone the repo and make a Python 3.11 environment: the command below, the next command, conda activate storymem
    git clone --single-branch --branch main git@github.com:Kevin-thu/StoryMem.git
    conda create -n storymem python=3.11
  2. 2
    Install the dependencies: the command below then pip install flash_attn
    pip install -r requirements.txt
  3. 3
    Download the models: the command below, the next command, the next command
    huggingface-cli download Wan-AI/Wan2.2-T2V-A14B --local-dir ./models/Wan2.2-T2V-A14B
    huggingface-cli download Wan-AI/Wan2.2-I2V-A14B --local-dir ./models/Wan2.2-I2V-A14B
    huggingface-cli download Kevin-thu/StoryMem --local-dir ./models/StoryMem
  4. 4
    Run the example: bash run_example.sh
  5. 5
    Change story_script_path, output_dir, max_memory_size, size and seed to fit your story

Models and languages

Models it works with

  • Wan 2.2 T2V-A14B
  • Wan 2.2 I2V-A14B
  • StoryMem Wan2.2 M2V-A14B
  • GPT-5

Interface and docs

  • English

Alternatives

Other model tooling projects people compare with StoryMem.

WeChatCV

Stand-In

Wan add-on that keeps one face consistent across shots

Model tooling
  • Wan 2.1 T2V 14B
  • Wan 2.2 T2V A14B
  • VACE
  • +2
790 GitHub stars-1/30d1 month agoApache-2.0

KlingAIResearch

ShotStream

Chains multi-shot video frames on the fly for interactive stories

Model tooling
  • Wan 2.1-T2V-1.3B
185 GitHub stars16 days agoNo license

aigc-apps

VideoX-Fun

Python toolkit that makes AI video and trains your own models

Model tooling
  • CogVideoX-Fun V1.1 2B
  • CogVideoX-Fun V1.1 5B
  • Wan 2.1-Fun 1.3B
  • +6
2.3k GitHub stars+2/30d3 days agoApache-2.0

deepbeepmeep

Wan2GP

Desktop app that runs open video, image and audio models on your own PC

Model tooling
  • Wan 2.1/2.2
  • MiniMax H3
  • LTX-2/2.3/2.5
  • +7
9.8k GitHub stars+32/30dyesterdayCustom license

Featured on OpenMicroDrama

Do you maintain StoryMem? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/kevin-thu-storymem)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 1, 2026. S-Lab License 1.0: non-commercial use only. Research code built on Wan2.2. We write these descriptions ourselves. The repo's own docs are the final word.