Skip to content

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.

0.3.7: on PyPI — pip install reshot / uvx reshot; install instructions updated everywhere

wangfengb7cf345b8976
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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's
diff --git a/README.md b/README.md
index 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 map
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 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.py
index 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.txt
index b324591..6d4fc33 100644
--- a/demo/requirements.txt
+++ b/demo/requirements.txt
@@ -1,5 +1,5 @@
--extra-index-url https://download.pytorch.org/whl/cpu
torch
torchvision
-reshot[ffmpeg] @ git+https://github.com/maosika-ai/[email protected]
+reshot[ffmpeg]==0.3.7
gradio>=4.0
diff --git a/demo/space/README.md b/demo/space/README.md
index 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 video
production system for AI short drama, AI short video and AI manhua drama: from a one-line idea to
diff --git a/demo/space/index.html b/demo/space/index.html
index 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 reshot
reshot 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>&lt;Video 1&gt;</code>, a character sheet as <code>&lt;Picture 1&gt;</code>; define <code>&lt;Video 1&gt;</code> as "the fight choreography and camera movement shown in &lt;Video 1&gt;, 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 挂成 &lt;Video 1&gt;、定妆图挂 &lt;Picture 1&gt;,明说灰色外观不要抄。三段片的完整提示词在 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.md
new file mode 100644
index 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.com
diff --git a/docs/USAGE.md b/docs/USAGE.md
index 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 if
diff --git a/docs/USAGE.zh-CN.md b/docs/USAGE.zh-CN.md
index 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.toml
index 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", "de
classifiers = [
"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.py
index d7b30e1..8879c6c 100644
--- a/reshot/_version.py
+++ b/reshot/_version.py
@@ -1 +1 @@
-__version__ = "0.3.6"
+__version__ = "0.3.7"