Skip to content

Commit 4f6a30f

Browse files
committed
[docs]: highlight Dreamverse deployment paths + add Server B200 (SSH) guide
Prep for the Dreamverse release by making the deploy story discoverable: - apps/dreamverse/README.md: add a top-level Deployment overview table (Local GPU / Server B200 SSH / Docker / Modal) and a new "Server B200 deployment (SSH)" section. The section links to the existing Install, FFmpeg, and Quick Start sections for the shared steps and documents only the server-specific deltas (bind 0.0.0.0, remote BACKEND_HOST, process supervision, port exposure) plus a first-boot warmup caveat. - README.md: add a Dreamverse highlight section and a Key Features bullet linking to the app, the live demo, and the deployment guide.
1 parent 2c13793 commit 4f6a30f

2 files changed

Lines changed: 61 additions & 0 deletions

File tree

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ FastVideo has the following features:
4242
- Support H100, A100, 4090
4343
- Support Linux, Windows, MacOS
4444
- See this [page](https://hao-ai-lab.github.io/FastVideo/inference/support_matrix/) for full list of supported models, hardware assumptions, and optimization compatibility.
45+
- Realtime video generation & editing
46+
- [Dreamverse](apps/dreamverse/README.md): stream and "vibe direct" video in realtime ([live demo](https://dreamverse.fastvideo.org/)), deployable on local GPU, a self-hosted B200 server, Docker, or serverless Modal
4547

4648
## Getting Started
4749

@@ -69,6 +71,19 @@ See below for recipes and datasets:
6971
| [FastWan2.1-T2V-1.3B](https://huggingface.co/FastVideo/FastWan2.1-T2V-1.3B-Diffusers) | [Recipe](https://github.com/hao-ai-lab/FastVideo/tree/main/examples/distill/Wan2.1-T2V/Wan-Syn-Data-480P) | [FastVideo Synthetic Wan2.1 480P](https://huggingface.co/datasets/FastVideo/Wan-Syn_77x448x832_600k) |
7072
| [FastWan2.2-TI2V-5B](https://huggingface.co/FastVideo/FastWan2.2-TI2V-5B-Diffusers) | [Recipe](https://github.com/hao-ai-lab/FastVideo/tree/main/examples/distill/Wan2.2-TI2V-5B-Diffusers/Data-free) | [FastVideo Synthetic Wan2.2 720P](https://huggingface.co/datasets/FastVideo/Wan2.2-Syn-121x704x1280_32k) |
7173

74+
## Dreamverse — Realtime Video Generation & Editing
75+
76+
[Dreamverse](apps/dreamverse/README.md) is FastVideo's realtime video generation
77+
and editing platform — "vibe directing" a video as it streams. It lives in the
78+
monorepo under [`apps/dreamverse/`](apps/dreamverse/) and ships its own backend
79+
(`dreamverse-server`) plus a web UI.
80+
81+
Try the [live demo](https://dreamverse.fastvideo.org/), read the
82+
[blog](https://haoailab.com/blogs/dreamverse/), or run it yourself. Dreamverse
83+
deploys on a local GPU, a self-hosted B200 server over SSH, Docker, or
84+
serverless [Modal](apps/dreamverse/scripts/modal/README.md) — see the
85+
[Dreamverse deployment guide](apps/dreamverse/README.md#deployment).
86+
7287
## Inference
7388

7489
### Generating Your First Video

apps/dreamverse/README.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,21 @@
22

33
Dreamverse is the FastVideo realtime video generation & editing platform. It lives in this monorepo under `apps/dreamverse/`.
44

5+
## Deployment
6+
7+
Dreamverse runs anywhere you have a CUDA NVIDIA GPU. Pick the path that fits:
8+
9+
| Method | Best for | Guide |
10+
| --- | --- | --- |
11+
| **Local GPU (native)** | Dev boxes, quick local demos | [Quick Start: Local GPU](#quick-start-local-gpu) |
12+
| **Server / bare-metal B200 (SSH)** | Persistent self-hosted serving | [Server B200 deployment (SSH)](#server-b200-deployment-ssh) |
13+
| **Docker** | Reproducible container build/run | [`docker/README.md`](docker/README.md) |
14+
| **Modal (serverless B200)** | On-demand cloud GPU, no infra to manage | [`scripts/modal/README.md`](scripts/modal/README.md) |
15+
16+
Whatever the target, the backend needs the prompt-LLM keys (`CEREBRAS_API_KEY`
17+
and `GROQ_API_KEY`) and serves on port `8009`: `/healthz` reports liveness and
18+
`/readyz` returns `200` once model load and startup warmup finish.
19+
520
## Install Dreamverse
621

722
You can install Dreamverse using one of the methods below.
@@ -163,6 +178,37 @@ BACKEND_HOST=localhost BACKEND_PORT=8009 npm run dev
163178

164179
Open `http://localhost:5299`.
165180

181+
## Server B200 deployment (SSH)
182+
183+
Deploying on a remote GPU host (for example a B200 box) is a local install run
184+
over SSH, plus a few server-specific concerns. Two paths:
185+
186+
### Option A: Native (source install)
187+
188+
SSH in, then follow [Install → From source](#method-2-from-source) and
189+
(recommended) [Building FFmpeg](#optional-building-ffmpeg-for-better-performance),
190+
then start the backend as in [Quick Start: Local GPU](#quick-start-local-gpu).
191+
For a remote host, a few things differ from localhost:
192+
193+
- Bind all interfaces: `dreamverse-server --host 0.0.0.0 --port 8009`.
194+
- Point the frontend/client at the host: `BACKEND_HOST=<b200-host> BACKEND_PORT=8009 npm run dev`.
195+
- Keep the backend alive across SSH sessions (`tmux` / `systemd` / `nohup`).
196+
- Expose / firewall port `8009`, or front it with a reverse proxy + auth.
197+
198+
### Option B: Docker (on the server)
199+
200+
SSH in, then follow [Install → Using Docker](#method-3-using-docker) and the run
201+
steps in [`docker/README.md`](docker/README.md):
202+
203+
```bash
204+
CEREBRAS_API_KEY="<key>" GROQ_API_KEY="<key>" apps/dreamverse/docker/docker_run.sh
205+
```
206+
207+
> **First-boot warmup:** `torch.compile` + startup warmup compiles the segment 1
208+
> and segment 2 inference paths and can take tens of minutes on a cold cache;
209+
> `/readyz` stays `503` until it finishes. Set `FASTVIDEO_ENABLE_STARTUP_WARMUP=0`
210+
> for a faster (uncompiled) startup while testing.
211+
166212
## Quick Start: Mock Backend (For UI development)
167213

168214
The mock server emulates the Dreamverse backend protocol and streams a

0 commit comments

Comments
 (0)