SolitaryThinker
0e0af68f01
Make the repo-local wrapper scripts the canonical Dreamverse launch path while package=false defers proper console-script packaging. Restore the bounded audio re-encode path from the product backend and document the verification prerequisites used for the migrated server boot probe.\n\nCo-authored-by: Junda (David) Su <90978028+Davids048@users.noreply.github.com>\nCo-authored-by: Matthew Noto <99706358+RandNMR73@users.noreply.github.com>\nCo-authored-by: XOR-op <17672363+XOR-op@users.noreply.github.com>\nCo-authored-by: Zhang Peiyuan <42993249+jzhang38@users.noreply.github.com>
2.2 KiB
Dreamverse Development
Dreamverse lives under apps/dreamverse/ as a product app inside the
FastVideo monorepo. Backend code uses the local FastVideo workspace package;
frontend tooling remains standalone under apps/dreamverse/web/.
Backend tests
Run CPU-safe backend tests from the FastVideo repository root:
uv run --locked --package dreamverse --extra test pytest apps/dreamverse/server/tests/ -m 'not gpu' -q
Backend launch
Launch the migrated backend through the repo-local wrappers:
apps/dreamverse/scripts/dreamverse-server --port 8009
apps/dreamverse/scripts/dreamverse-mock-server --port 8009
Do not rely on a bare dreamverse-server found on PATH during the migration.
With [tool.uv] package = false, uv does not register this workspace member's
console scripts, so a PATH binary can still point at an old Dreamverse editable
install outside this monorepo.
Frontend build and tests
Run frontend commands from the standalone web app:
cd apps/dreamverse/web
pnpm install --frozen-lockfile
pnpm run build
pnpm run test
Playwright is intentionally run against a live backend as part of the GPU4 manual verification flow, not in the Phase 3 migration gate.
Local GPU4 verification hook
Use physical GPU 4 for migration smoke tests. CUDA_VISIBLE_DEVICES=4 makes
that GPU appear as logical GPU 0 inside the process, preserving the previous
Dreamverse deployment behavior.
CUDA_VISIBLE_DEVICES=4 apps/dreamverse/scripts/dreamverse-server \
--host 0.0.0.0 --port 8009
In another shell, verify the service:
curl -s http://localhost:8009/healthz
Phase 4 adds the public /healthz, /readyz, /status,
/prompt-system-config, and /curated-presets route coverage needed for the
full Playwright suite.
Phase 0 production-equivalent prerequisites
For the production-equivalent NVFP4 path, install these optional dependencies
in the FastVideo .venv before GPU4 smoke tests:
.venv/bin/pip install flashinfer-python flash-attn --no-build-isolation
flashinfer-python is required for NVFP4 quantization. flash-attn is
optional but recommended; without it, attention falls back to Torch SDPA.