whatisgithub

What is joyai-echo?

jd-opensource/joyai-echo — explained in plain English

Analysis updated 2026-05-18

758PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

JoyAI-Echo is JD.com's inference-only research model that generates coherent, up to five-minute multi-shot videos with synchronized audio from text prompts.

Mindmap

mindmap
  root((JoyAI-Echo))
    What it does
      Generates long multi-shot video
      Synchronized audio and video
      Cross-modal memory bank
      Distilled for 7.5x speedup
    Tech stack
      Python
      PyTorch
      CUDA
    Use cases
      Minute-level story video
      Consistent character generation
      Research benchmarking
    Audience
      AI researchers
      Video generation engineers

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

What do people build with it?

USE CASE 1

Generate a coherent multi-shot video story up to five minutes long from a JSON prompt file.

USE CASE 2

Produce synchronized audio and video in a single generation pipeline instead of adding audio separately.

USE CASE 3

Use the prompt-enhancer templates to expand a short story idea into detailed shot descriptions.

USE CASE 4

Compare long-form video generation quality against JD's other model, HappyOyster.

What is it built with?

PythonPyTorchCUDA

How does it compare?

jd-opensource/joyai-echopaddlepaddle/paddlemixdeusyu/translate-book
Stars758724716
LanguagePythonPythonPython
Last pushed2026-03-06
MaintenanceMaintained
Setup difficultyhardhardmoderate
Complexity5/54/53/5
Audienceresearcherdevelopervibe coder

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a modern NVIDIA GPU with CUDA and roughly 70GB of model weights, including a Gemma text encoder, downloaded separately.

The README does not state a license.

So what is it?

JoyAI-Echo is a research framework from JD.com that generates long videos up to five minutes in length from text descriptions. Unlike most video generation tools that produce short clips of a few seconds, this project focuses on creating coherent multi-shot sequences where characters look and sound consistent from one scene to the next. It produces synchronized audio alongside the video in a single pipeline rather than adding audio as a separate step afterward. The central technical idea is a shared memory bank that stores the visual appearance of characters and the sound of their voices after each generated scene, then uses that stored information to condition each new scene that follows. This is what allows a five-minute video to maintain recognizable characters across many different shots. The system also uses a distillation technique to speed up the slow diffusion-based generation process by roughly 7.5 times compared to the original approach. The project is described as inference-only, meaning it includes pre-trained model weights and the code to run them, but not the code or data used to train the model from scratch. The model weights total around 70 gigabytes across the main model file and a text-understanding component from Google called Gemma. Running the system requires a modern NVIDIA GPU with CUDA support and substantial video memory. Generating a video starts with a JSON file listing one or more shot descriptions. The README recommends running your initial idea through a provided prompt-enhancer prompt before writing the final shot descriptions, because bare short prompts produce noticeably weaker results. Each shot description should cover the roles and subjects in the scene, the environment, the action, audio elements, the camera angle, and the desired mood. The release comes from JD.com's open-source team and is accompanied by a research paper. Human evaluation results in the paper show it outperforming another JD model called HappyOyster on long-form video across visual quality, audio quality, and prompt following. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through downloading JoyAI-Echo's checkpoints and Gemma text encoder and setting up the conda environment.
Prompt 2
Help me write a multi-shot prompt JSON file for JoyAI-Echo covering roles, environment, action, and camera angle.
Prompt 3
Explain how JoyAI-Echo's cross-modal memory bank keeps character appearance and voice consistent across shots.
Prompt 4
Run JoyAI-Echo's prompt enhancer on my short story idea before generating a multi-shot video.

Frequently asked questions

What is joyai-echo?

JoyAI-Echo is JD.com's inference-only research model that generates coherent, up to five-minute multi-shot videos with synchronized audio from text prompts.

What language is joyai-echo written in?

Mainly Python. The stack also includes Python, PyTorch, CUDA.

What license does joyai-echo use?

The README does not state a license.

How hard is joyai-echo to set up?

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

Who is joyai-echo for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.