diff --git a/community/cbag/README.md b/community/cbag/README.md new file mode 100644 index 0000000..8fc98a4 --- /dev/null +++ b/community/cbag/README.md @@ -0,0 +1,116 @@ +# 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://: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://: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.