mirror of
https://github.com/NVIDIA/dgx-spark-playbooks.git
synced 2026-06-24 07:09:31 +00:00
117 lines
5.2 KiB
Markdown
117 lines
5.2 KiB
Markdown
# Corporate Bullshit Agentic Generator (CBAG)
|
||
|
||
> Generate a lip-synced talking-head video of someone delivering AI-written corporate buzzword nonsense — 100% locally on your DGX Spark.
|
||
|
||
## Table of Contents
|
||
|
||
- [Overview](#overview)
|
||
- [Instructions](#instructions)
|
||
- [Troubleshooting](#troubleshooting)
|
||
|
||
---
|
||
|
||
## Overview
|
||
|
||
## Basic idea
|
||
|
||
CBAG is a fully local, GPU-native demo that turns a topic and a persona into a short video of a "person" delivering confident corporate nonsense. It chains four model families on a single DGX Spark:
|
||
|
||
1. **Buzzword grammar** — a deterministic generator seeds the nonsense (no GPU).
|
||
2. **LLM refine** — a local Ollama model (default `qwen2.5:3b`) rewrites it into an on-persona monologue (visionary CEO, McKinsey consultant, startup founder, thought leader).
|
||
3. **Voice** — Kokoro default voices, or your **own cloned voice** from a ~10 s sample (Qwen3-TTS).
|
||
4. **Talking-head video** — ComfyUI + Sonic + Stable Video Diffusion animate a portrait (a default face, or your uploaded photo) to lip-sync the speech.
|
||
|
||
Everything runs in one `docker compose` stack, exposed as a small web app. No cloud, no API tokens — a fun, honest stress-test of the Spark's unified memory (a 20B-class LLM, two speech models, and a video diffusion stack, warm at once).
|
||
|
||
## What you'll accomplish
|
||
|
||
You'll install CBAG on your DGX Spark and generate a talking-head video from a topic + persona in your browser, optionally in your own cloned voice.
|
||
|
||
## What to know before starting
|
||
|
||
- Basic command line and `git` usage
|
||
- Familiarity with Docker / Docker Compose and GPU containers
|
||
- That model weights are downloaded from their official sources on first install
|
||
|
||
## Prerequisites
|
||
|
||
**Hardware Requirements:**
|
||
- NVIDIA Grace Blackwell GB10 Superchip system (DGX Spark / Dell GB10), 128 GB unified memory
|
||
- At least ~50 GB available storage (container images + model weights)
|
||
|
||
**Software Requirements:**
|
||
- DGX OS / Ubuntu 24.04 with CUDA 13
|
||
- Docker + Docker Compose v2 + NVIDIA Container Toolkit: `docker compose version`
|
||
- Git: `git --version`
|
||
- A web browser with access to `https://<SPARK_IP>:8443`
|
||
|
||
## Ancillary files
|
||
|
||
All assets live in the CBAG repository (Apache-2.0): **https://github.com/vitorallo/CBAG**
|
||
|
||
Model weights are **not** bundled — `scripts/fetch-models.sh` downloads each from its official source at install time and verifies it by SHA-256. See the repo's `MODELS.md` for every model, its source, and its license.
|
||
|
||
> **Licensing note:** the talking-head video models (Stable Video Diffusion and Sonic) are licensed for **non-commercial** use only, so the talking-head feature of this demo is non-commercial. The text and voice stages use permissive (Apache-2.0/MIT) models. See `MODELS.md`.
|
||
|
||
## Time & risk
|
||
|
||
* **Estimated time:** 30–45 minutes (first build + model downloads)
|
||
* **Risk level:** Medium
|
||
* Model downloads are large (~15–20 GB total) and may fail on flaky networks — `build.sh` is idempotent, just re-run it.
|
||
* Port 443 is often taken by the pre-installed Dell demo, so CBAG serves HTTPS on **8443**.
|
||
* **Rollback:** `./scripts/down.sh` stops the stack; `./scripts/down.sh --purge` also removes the model volumes.
|
||
* **Last Updated:** 06/21/2026
|
||
* Initial release.
|
||
|
||
## Instructions
|
||
|
||
## Step 1. Verify system prerequisites
|
||
|
||
Confirm your DGX Spark meets the requirements.
|
||
|
||
```bash
|
||
uname -m # aarch64
|
||
docker compose version # Compose v2
|
||
nvidia-smi # GPU detected
|
||
df -h . # ~50 GB free
|
||
```
|
||
|
||
## Step 2. Clone CBAG
|
||
|
||
```bash
|
||
git clone https://github.com/vitorallo/CBAG.git
|
||
cd CBAG
|
||
```
|
||
|
||
## Step 3. Build (preflight + auto-configure + images + weights)
|
||
|
||
```bash
|
||
./scripts/build.sh
|
||
```
|
||
|
||
This auto-detects your box's LAN/Tailscale IPs and writes `.env`, generates a self-signed TLS cert for those addresses, builds the container images, and downloads all model weights from their official sources (each verified by SHA-256). No Hugging Face token is required for the default sources.
|
||
|
||
## Step 4. Start the stack
|
||
|
||
```bash
|
||
./scripts/run.sh
|
||
```
|
||
|
||
It waits for the services to become healthy and prints the URL, e.g. `https://<your-spark-ip>:8443`.
|
||
|
||
## Step 5. Generate
|
||
|
||
Open the printed **https://** URL. On first visit, accept the self-signed certificate once (Advanced → Proceed) — HTTPS is required so the in-browser microphone (for voice cloning) works.
|
||
|
||
Pick a **topic** and a **persona**, then **Generate**. The text appears first, then the audio, then the talking-head video. Optionally upload a portrait (≥512 px) or record/upload a voice sample to clone your own voice.
|
||
|
||
Stop the stack any time with `./scripts/down.sh`.
|
||
|
||
## Troubleshooting
|
||
|
||
- **Port 443 already in use** — expected on a Spark (the pre-installed Dell demo owns it); CBAG serves HTTPS on **8443**.
|
||
- **Microphone is blocked** — you must use the `https://…:8443` URL (a secure context), not `http://…:8000`.
|
||
- **First voice-clone is slow** — the Qwen3-TTS model (~4 GB) downloads once on first use; the default Kokoro voices are instant.
|
||
- **A weight download failed** — re-run `./scripts/build.sh` (it skips what's already present and verifies SHA-256).
|
||
- **Render takes a while** — talking-head render time scales with audio length; choose a *short* length for a snappy demo.
|