Skip to content

Commit e9a10c1

Browse files
committed
[docs]: add Dreamverse Server B200 (SSH) deploy guide + release highlight
Prep for the Dreamverse release: - apps/dreamverse/README.md: add a "Server B200 deployment (SSH)" section with native (source install) and Docker options, linking to the existing Install / FFmpeg / Quick Start sections for the shared steps and documenting only the server-specific deltas (bind 0.0.0.0, remote BACKEND_HOST, process supervision, port exposure). Add a general first-boot warmup expectation note under "Launch Dreamverse" (torch.compile warmup can take tens of minutes on a cold cache regardless of deploy method; FASTVIDEO_ENABLE_STARTUP_WARMUP=0 to skip while testing). - README.md: add a Dreamverse highlight section and a Key Features bullet linking to the app and the live demo.
1 parent 2c13793 commit e9a10c1

2 files changed

Lines changed: 49 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 README](apps/dreamverse/README.md).
86+
7287
## Inference
7388

7489
### Generating Your First Video

apps/dreamverse/README.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,14 @@ dreamverse-server --port 8009
9393
dreamverse-mock-server --port 8009
9494
```
9595

96+
> **Expect a slow first boot.** With `torch.compile` and startup warmup enabled
97+
> (the default), the backend compiles the segment 1 and segment 2 inference
98+
> paths before it reports ready — this can take **tens of minutes on a cold
99+
> cache**, regardless of how you deploy (local, server, Docker, or Modal).
100+
> `/healthz` responds as soon as the process is up; `/readyz` stays `503` until
101+
> warmup finishes. For a faster, uncompiled startup while testing, set
102+
> `FASTVIDEO_ENABLE_STARTUP_WARMUP=0` before starting the backend.
103+
96104
## Frontend Setup
97105

98106
Install the web dependencies once from the FastVideo checkout:
@@ -163,6 +171,32 @@ BACKEND_HOST=localhost BACKEND_PORT=8009 npm run dev
163171

164172
Open `http://localhost:5299`.
165173

174+
## Server B200 deployment (SSH)
175+
176+
Deploying on a remote GPU host (for example a B200 box) is a local install run
177+
over SSH, plus a few server-specific concerns. Two paths:
178+
179+
### Option A: Native (source install)
180+
181+
SSH in, then follow [Install → From source](#method-2-from-source) and
182+
(recommended) [Building FFmpeg](#optional-building-ffmpeg-for-better-performance),
183+
then start the backend as in [Quick Start: Local GPU](#quick-start-local-gpu).
184+
For a remote host, a few things differ from localhost:
185+
186+
- Bind all interfaces: `dreamverse-server --host 0.0.0.0 --port 8009`.
187+
- Point the frontend/client at the host: `BACKEND_HOST=<b200-host> BACKEND_PORT=8009 npm run dev`.
188+
- Keep the backend alive across SSH sessions (`tmux` / `systemd` / `nohup`).
189+
- Expose / firewall port `8009`, or front it with a reverse proxy + auth.
190+
191+
### Option B: Docker (on the server)
192+
193+
SSH in, then follow [Install → Using Docker](#method-3-using-docker) and the run
194+
steps in [`docker/README.md`](docker/README.md):
195+
196+
```bash
197+
CEREBRAS_API_KEY="<key>" GROQ_API_KEY="<key>" apps/dreamverse/docker/docker_run.sh
198+
```
199+
166200
## Quick Start: Mock Backend (For UI development)
167201

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

0 commit comments

Comments
 (0)