ReShot — copy the shot, not the actors. Video → depth map, OpenPose skeleton or canny lines for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet and Wan VACE. Apache-2.0. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system.
Python ai-short-dramaai-videocannycomfyuicontrolnetdepth-anythingdepth-estimationdwposemaosikaminimaxopenposepose-controlnetpose-estimationseedanceshort-dramavideo-generationvideo-to-videowan
0.3.7: on PyPI — pip install reshot / uvx reshot; install instructions updated everywhere
wangfengb7cf345b8976
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex cabcac6..827c504 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,8 @@# Changelog+## 0.3.7 — 2026-09-12+- **On PyPI**: `pip install reshot` (and `uvx reshot …`). No git needed any more.+## 0.3.6 — 2026-09-12- **`--quality fast` is the default** (the model sees 644×364 for 16:9, 364×644 for 9:16;~3 GB VRAM, 34 ms/frame on a 3080 Ti). `full` (924×518 / 518×924, ~11 GB) is the user'sdiff --git a/README.md b/README.mdindex 548df84..23d208f 100644--- a/README.md+++ b/README.md@@ -38,10 +38,10 @@ The three takes in the demo were made exactly this way. Every file involved is i### 1. Install```bash-pip install git+https://github.com/maosika-ai/reshot # needs ffmpeg on PATH+pip install reshot # needs ffmpeg on PATH```-No ffmpeg? `pip install "reshot[ffmpeg] @ git+https://github.com/maosika-ai/reshot"` bundles one. The model weights (111 MB) download on first run.+No ffmpeg? `pip install "reshot[ffmpeg]"` bundles one. No Python set up at all? [uv](https://docs.astral.sh/uv/) does everything in one line: `uvx --from "reshot[ffmpeg]" reshot reference.mp4 -o depth.mp4 --target seedance`. The model weights (111 MB) download on first run.### 2. Make the depth mapdiff --git a/README.zh-CN.md b/README.zh-CN.mdindex a1608c2..053d101 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -38,10 +38,10 @@ ReShot 吃进一个 `.mp4`,吐出一个 `.mp4`。输出是一段**深度图视### 1. 装```bash-pip install git+https://github.com/maosika-ai/reshot # 需要 PATH 里有 ffmpeg+pip install reshot # 需要 PATH 里有 ffmpeg```-没有 ffmpeg 就装 `pip install "reshot[ffmpeg] @ git+https://github.com/maosika-ai/reshot"`,自带一个。模型权重 111 MB,首次运行自动下载;国内先 `export HF_ENDPOINT=https://hf-mirror.com`。+没有 ffmpeg 就装 `pip install "reshot[ffmpeg]"`,自带一个。连 Python 都没配?用 [uv](https://docs.astral.sh/uv/) 一行搞定:`uvx --from "reshot[ffmpeg]" reshot 参考片.mp4 -o 深度图.mp4 --target seedance`。模型权重 111 MB,首次运行自动下载;国内先 `export HF_ENDPOINT=https://hf-mirror.com`。### 2. 抽深度图diff --git a/demo/app.py b/demo/app.pyindex 4918539..2cd3cdd 100644--- a/demo/app.py+++ b/demo/app.py@@ -61,7 +61,7 @@ Keeps a shot's staging and camera, drops faces, wardrobe and style.Code and CLI: [github.com/maosika-ai/reshot](https://github.com/maosika-ai/reshot) · Apache-2.0*This free-CPU demo processes the first **{LIMITS["max_seconds"]} s** at ≤ {LIMITS["max_res"]} px.-Expect 1–3 minutes. For full clips and GPU speed, run it locally: `pip install git+https://github.com/maosika-ai/reshot`.*+Expect 1–3 minutes. For full clips and GPU speed, run it locally: `pip install reshot`.*""")with gr.Row():diff --git a/demo/requirements.txt b/demo/requirements.txtindex b324591..6d4fc33 100644--- a/demo/requirements.txt+++ b/demo/requirements.txt@@ -1,5 +1,5 @@--extra-index-url https://download.pytorch.org/whl/cputorchtorchvision-reshot[ffmpeg] @ git+https://github.com/maosika-ai/[email protected]+reshot[ffmpeg]==0.3.7gradio>=4.0diff --git a/demo/space/README.md b/demo/space/README.mdindex ec6c197..a5d092d 100644--- a/demo/space/README.md+++ b/demo/space/README.md@@ -18,7 +18,7 @@ its faces, wardrobe or style.- Presets for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet, Wan VACE.- Code, CLI, docs: https://github.com/maosika-ai/reshot (Apache-2.0)- Model: Video Depth Anything Small (Apache-2.0, ByteDance, CVPR 2025)-- This Space is a static landing page; the tool runs locally (`pip install git+https://github.com/maosika-ai/reshot`).+- This Space is a static landing page; the tool runs locally (`pip install reshot`).ReShot is open-sourced by [Maosika 猫斯卡](https://www.maosika.com) — a professional AI videoproduction system for AI short drama, AI short video and AI manhua drama: from a one-line idea todiff --git a/demo/space/index.html b/demo/space/index.htmlindex e35f1d5..36a69ea 100644--- a/demo/space/index.html+++ b/demo/space/index.html@@ -35,7 +35,7 @@<video class="demo" src="demo.mp4" poster="demo.gif" autoplay muted loop playsinline></video><p class="cap">top: the reference and its depth map · bottom: three takes generated from that depth map — two women, one rabbit; same moves, same camera<br><span class="zh">上排:参考片和它的深度图 · 下排:用这张深度图生成的三段片——两个女人、一只兔子;动作一样,镜头一样</span></p>-<pre><code>pip install git+https://github.com/maosika-ai/reshot+<pre><code>pip install reshotreshot reference.mp4 -o depth.mp4 --target seedance</code></pre><div class="row">@@ -55,7 +55,7 @@ reshot reference.mp4 -o depth.mp4 --target seedance</code></pre><h2>How to use it <span class="zh">/ 怎么用</span></h2><table>-<tr><td><b>1</b></td><td><code>pip install git+https://github.com/maosika-ai/reshot</code><br><span class="zh">装</span></td></tr>+<tr><td><b>1</b></td><td><code>pip install reshot</code><br><span class="zh">装</span></td></tr><tr><td><b>2</b></td><td><code>reshot reference.mp4 -o depth.mp4 --target seedance</code> — 24 fps, H.264, the Seedance reference-video spec out of the box; <code>--target h3</code> for MiniMax H3.<br><span class="zh">抽深度图;<code>--target seedance</code> 直接按 Seedance 参考视频规格出片</span></td></tr><tr><td><b>3</b></td><td><b>Seedance 2.0 / 2.5:</b> upload <code>depth.mp4</code> as a reference video and prompt <code>参考@视频1的动作与运镜,顺序与视频保持一致。</code> + the people and the look.<br><b>MiniMax H3:</b> attach it as <code><Video 1></code>, a character sheet as <code><Picture 1></code>; define <code><Video 1></code> as "the fight choreography and camera movement shown in <Video 1>, a grey depth map…" and state that "its grey depth look is not transferred". The full prompts for the three takes are in <a href="https://github.com/maosika-ai/reshot/tree/main/docs/prompts">docs/prompts</a>.<br><span class="zh">交给模型:Seedance 当参考视频上传并写「参考@视频1的动作与运镜」;MiniMax H3 挂成 <Video 1>、定妆图挂 <Picture 1>,明说灰色外观不要抄。三段片的完整提示词在 docs/prompts。</span></td></tr><tr><td><b>4</b></td><td>Same six shots, same camera, your cast — the three takes above. Tips that made them work: keep the reference under 15 s; for MiniMax H3 shrink the depth map (<code>--max-res 320</code>) so the grey silhouette doesn't pull the face shape; keep the size ratio between characters as the depth map has it.<br><span class="zh">出片。几条经验:参考片 15 秒以内;给 MiniMax H3 的深度图缩到 320(不然灰影会带脸型);角色体量比例别跟深度图打架。</span></td></tr>diff --git a/docs/PYPI.md b/docs/PYPI.mdnew file mode 100644index 0000000..2e613c3--- /dev/null+++ b/docs/PYPI.md@@ -0,0 +1,22 @@+# ReShot++**Copy the shot, not the actors.**++ReShot turns a reference video into a depth-map video (near = white, far = black), so Seedance, MiniMax H3 or Wan can repeat its choreography and camera moves with your own characters.++```bash+pip install reshot+reshot reference.mp4 -o depth.mp4 --target seedance+```++- Presets for **Seedance 2.0 / 2.5** reference video (`--target seedance`), **MiniMax H3** (`h3`), **Wan 2.1 VACE** (`wan`).+- `--quality fast` (default; the model sees 644×364 for 16:9, ~3 GB VRAM) or `full` (924×518, ~11 GB).+- Depth normalised once over the whole clip — no flicker; frames picked by timestamp; sizes cropped to the model's grid, never padded.+- Batch a folder in one model load: `reshot clips/*.mp4 -o depth/`.+- Python API: `from reshot import RunConfig, run`.+- Apache-2.0, including the default model (Video Depth Anything Small).+- ComfyUI nodes: https://github.com/maosika-ai/ComfyUI-ReShot++Full guide, demo, measured performance and the prompts that made the demo takes: **https://github.com/maosika-ai/reshot**++Open-sourced by [Maosika 猫斯卡](https://www.maosika.com), the AI short-drama production system — from a one-line idea to episodic script, character sheets, scene images and every shot rendered with Seedance and MiniMax H3. https://www.maosika.comdiff --git a/docs/USAGE.md b/docs/USAGE.mdindex ab8539a..6e7ab7a 100644--- a/docs/USAGE.md+++ b/docs/USAGE.md@@ -16,10 +16,10 @@ Requirements: Python ≥ 3.10, PyTorch ≥ 2.1 (CPU, CUDA or Apple MPS), ffmpeg.```bash# with your own ffmpeg on PATH-pip install git+https://github.com/maosika-ai/reshot+pip install reshot# no ffmpeg? this extra bundles a static binary-pip install "reshot[ffmpeg] @ git+https://github.com/maosika-ai/reshot"+pip install "reshot[ffmpeg]"```PyTorch is not pinned to a CUDA version; install the build for your machine first ifdiff --git a/docs/USAGE.zh-CN.md b/docs/USAGE.zh-CN.mdindex d0ad35c..da29220 100644--- a/docs/USAGE.zh-CN.md+++ b/docs/USAGE.zh-CN.md@@ -16,10 +16,10 @@```bash# 自己有 ffmpeg-pip install git+https://github.com/maosika-ai/reshot+pip install reshot# 没有 ffmpeg?这个 extra 自带一个静态二进制-pip install "reshot[ffmpeg] @ git+https://github.com/maosika-ai/reshot"+pip install "reshot[ffmpeg]"```PyTorch 不锁 CUDA 版本;如果 `pip` 装错了,先按 https://pytorch.org/get-started/locally/ 装好再装 reshot。diff --git a/pyproject.toml b/pyproject.tomlindex 8b1b57a..1fdad20 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"name = "reshot"dynamic = ["version"]description = "ReShot — copy the shot, not the actors. Video → depth map for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet and Wan VACE. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system."-readme = "README.md"+readme = "docs/PYPI.md"license = { text = "Apache-2.0" }requires-python = ">=3.10"authors = [{ name = "Maosika 猫斯卡" }]@@ -14,7 +14,13 @@ keywords = ["video", "depth", "controlnet", "video-generation", "depth-map", "declassifiers = ["License :: OSI Approved :: Apache Software License","Programming Language :: Python :: 3",+ "Programming Language :: Python :: 3.10",+ "Programming Language :: Python :: 3.11",+ "Programming Language :: Python :: 3.12","Topic :: Multimedia :: Video",+ "Topic :: Multimedia :: Graphics",+ "Intended Audience :: End Users/Desktop",+ "Operating System :: OS Independent",]dependencies = ["torch>=2.1",@@ -36,6 +42,9 @@ reshot = "reshot.cli:main"[project.urls]Homepage = "https://github.com/maosika-ai/reshot"+Documentation = "https://github.com/maosika-ai/reshot/blob/main/docs/USAGE.md"+"ComfyUI nodes" = "https://github.com/maosika-ai/ComfyUI-ReShot"+Changelog = "https://github.com/maosika-ai/reshot/blob/main/CHANGELOG.md"Maosika = "https://www.maosika.com"[tool.setuptools.dynamic]diff --git a/reshot/_version.py b/reshot/_version.pyindex d7b30e1..8879c6c 100644--- a/reshot/_version.py+++ b/reshot/_version.py@@ -1 +1 @@-__version__ = "0.3.6"+__version__ = "0.3.7"