gitwtfhub

wtf is cma-harness?

caseclose/cma-harness — explained in plain English

Analysis updated 2026-05-18

12HTMLAudience · researcherComplexity · 5/5Setup · hard

TL;DR

A research AI agent that remembers past images in a conversation by compressing them into short descriptions, then retrieves only what matters to generate, edit, or understand new images.

Mindmap

mindmap
  root((repo))
    What it does
      Long horizon visual memory
      Selective retrieval
      Multimodal task routing
    Method pieces
      Episodic Visual Memory
      Executive Controller
    Use cases
      Study memory techniques
      Benchmark retrieval
      Reference agent design
    Audience
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Study techniques for giving multimodal AI systems long-term visual memory across many conversation turns.

REASON 2

Benchmark a multimodal agent's retrieval accuracy using the M2CA-Bench evaluation set.

REASON 3

Reference the memory and retrieval design when building a multi-turn image generation or editing agent.

How it stacks up

caseclose/cma-harnessagentzh/agentzh.orgenriquevelmai/gnm-maya
Stars121212
LanguageHTMLHTMLHTML
Last pushed2017-04-06
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity5/51/53/5
Audienceresearcherwriterdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

The code and M2CA-Bench dataset are noted as being released, so a working install may not be fully available yet.

Wtf does this do

CMA-Harness is a research project from Peking University and Tencent's WeChat Vision team about building an AI agent that can understand, generate, and edit images and other visual content over long conversations. The core idea is that instead of trying to keep every image from a conversation in the AI's working memory at once, the system compresses past images into short descriptions, tags, and thumbnails. It then pulls back only the specific past images that matter for the current question, which the authors call selective retrieval. The project names its two main pieces: an Episodic Visual Memory that stores this compressed history, and a Multimodal Executive Controller that decides whether a new message needs the AI to understand something, generate a new image, edit an existing one, or combine several images together, then sends the task to the right process. Together these form what the authors call a cognitive structured multimodal agent, with CMA-Harness being the deployable version that adds tool support for real multi-session use. Alongside the agent, the authors built a benchmark called M2CA-Bench to test how well systems like this handle long conversations involving images. It contains 100 sessions of 20 turns each, covering 55 topics across 8 subject areas, with four levels of difficulty. The benchmark deliberately includes near duplicate images that differ only in small details like color or lighting, so that a system cannot cheat by guessing rather than actually retrieving the right image. According to the reported results, the system retrieves the correct past image around 91 percent of the time across full sessions, drops slightly to about 89 percent on longer sessions, and reaches 82 percent on the hardest cases. It also runs roughly twice as fast per turn compared to a simpler approach that tries to keep the entire conversation in context at once. The README notes that the code and the M2CA-Bench dataset will be released, meaning the actual software may not be fully available yet at the time this was written. There is an accompanying academic paper describing the method and results in full technical detail.

Yoink these prompts

Prompt 1
Explain how Episodic Visual Memory and the Multimodal Executive Controller work together in CMA-Harness.
Prompt 2
Summarize the M2CA-Bench evaluation setup and what its difficulty strata measure.
Prompt 3
Help me understand the retrieval accuracy results reported across the All, Long, and Hard subsets.

Frequently asked questions

wtf is cma-harness?

A research AI agent that remembers past images in a conversation by compressing them into short descriptions, then retrieves only what matters to generate, edit, or understand new images.

What language is cma-harness written in?

Mainly HTML.

How hard is cma-harness to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is cma-harness for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.