# JoyAI-Video-Edit
**Repository Path**: alimei/JoyAI-Video-Edit
## Basic Information
- **Project Name**: JoyAI-Video-Edit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
JoyAI-Video-Edit
Real-Time Open-Ended Video Editing with Autoregressive Diffusion
JoyAI-Video-Edit is a real-time, instruction-guided video editing system for open-ended video streams. Given a live camera stream or uploaded video and a natural-language edit instruction, it edits frames causally as they arrive, without waiting for the full video, requiring a predefined video length, or revisiting future frames. In our deployment benchmark, the full end-to-end pipeline reaches 30.19 FPS at 720x1280, pushing video editing from offline batch processing toward interactive streaming generation.
The system combines an MLLM-based condition encoder, a causal video VAE, and a 16B-parameter multimodal diffusion transformer. It is trained and deployed as an autoregressive diffusion editor, then accelerated with aligned autoregressive distribution matching distillation, long-horizon optimization, bounded KV-state inference, and deployment-oriented scheduling to sustain high-throughput 720p editing while reducing train-inference mismatch and accumulated temporal drift.
## π₯π₯π₯ News!!
- 2026.08.06: π We are excited to release the live demo of our real-time video editing modelβtry it here:
.
- 2026.08.05: π We release the deployment code, [technical report](https://arxiv.org/pdf/2608.03974), online demo, and JoyAI-Video-Edit checkpoints. Please check the links above for details.
## π Highlights
- **Real-time open-ended editing.** Edits live or uploaded videos as frames arrive, without requiring the full sequence upfront.
- **Diverse instruction control.** Supports subject edits, local edits, background changes, style transfer, motion changes, and reference-guided editing.
- **Autoregressive diffusion design.** Combines an MLLM condition encoder, causal video VAE, and MMDiT backbone for streaming video editing.
- **High-throughput 720p deployment.** Reaches 30.19 FPS end-to-end throughput at 720x1280 with bounded KV-state inference and stable per-chunk compute.
## π§ TODO
- [ ] **Consumer GPU support.** Optimize deployment for consumer-grade GPUs such as GeForce RTX 5090.
- [ ] **Stronger model version in progress.** A more powerful version is under active development, with a particular focus on advancing reference-image-guided video editing (RV2V) capabilities.
- [ ] **Release full training and data pipelines.** Open-source the complete training framework and data generation pipeline.
## π¬ Showcase
JoyAI-Video-Edit is designed for broad video editing tasks, including global appearance changes, local object edits, subject add/remove/replace, background replacement, style transfer, and reference-guided edits.
https://github.com/user-attachments/assets/bca232c9-75df-46f9-b366-14cfa2651994
| Source |
Prompt |
Edited |
 |
Transform the people, hairstyles, and interior into a British castle aristocratic style. |
 |
 |
Turn the video into a watercolor wash style. |
 |
 |
Make all dogs white, add colorful hats, and turn the sunglasses hot pink. |
 |
 |
Dress the girl in a brown down jacket and blue baseball cap. |
 |
 |
Remove the two white cats in pink clothes on both sides. |
 |
## π¦ Model Download
Download the released JoyAI-Video-Edit weights from [Hugging Face](https://huggingface.co/jdopensource/JoyAI-Video-Edit), then place them under:
```text
deploy/deps/checkpoints/JoyAI-Video-Edit/
|-- dit/
| `-- joyai_video_edit_dit_0804.pth
`-- vae/
|-- config.json
`-- diffusion_pytorch_model.safetensors
```
## π Quick Start
### 1. Install
```bash
conda create -n joyai-video-edit python=3.10 -y
conda activate joyai-video-edit
python -m pip install -r requirements.txt
```
### 2. Prepare Checkpoints
Download the released weights from the Hugging Face link above. MiMo-VL and the ONNX detector files are external runtime dependencies; see [`DEPLOYMENT.md`](DEPLOYMENT.md) for deployment details.
### 3. Launch
```bash
cd deploy
bash run_server.sh
```
Then open:
```text
http://localhost:8080
```
For remote machines, bind the server to `0.0.0.0` and open the selected port, or use SSH port forwarding.
## π οΈ Custom Deployment
For custom deployment, edit `deploy/run_server.sh` to set checkpoint paths, CUDA device placement, host, and port. The default script also sets persistent TorchInductor, Triton, and CUDA cache directories so compile artifacts are reused across launches.
`TORCHINDUCTOR_AUTOGRAD_CACHE` is not required for inference-only serving.
## π Citation
If JoyAI-Video-Edit is useful for your research or product prototype, please cite:
```bibtex
@article{xiao2026joyai,
title={JoyAI-Video-Edit: Real-Time Open-Ended Video Editing with Autoregressive Diffusion},
author={Xiao, Yicheng and Dai, Wenxun and Qin, Xinran and Song, Lin and Zhang, Maoquan and Xu, Hang and Chen, Yukang and Li, Yitong and Zhang, Guohui and Zhang, Yuan and Zhang, Xuying and Zhang, Tommy and Yuan, Jianlong and Li, Peihao and Lu, Shuai and Fu, Siming and Zhao, Chuyang and Han, Xin and Huang, Jie and Li, Wenbo and Ma, Guoqing and Huang, Wei and Qi, Xiaojuan and Huang, Haoyang and Duan, Nan},
journal={arXiv preprint arXiv:2608.03974},
year={2026}
}
```
## βοΈ License Agreement
JoyAI-Video-Edit is licensed under Apache 2.0.