@argo-video/cli 0.7.1 → 0.9.0

package/dist/tts/engines/mlx-audio.js

@@ -1,25 +1,67 @@
 export class MlxAudioEngine {
     baseUrl;
     model;
+    serverOptions;
     constructor(options) {
         this.baseUrl = options?.baseUrl ?? 'http://localhost:8000';
         this.model = options?.model ?? 'mlx-community/Spark-TTS-0.5B-bf16';
+        if (options?.refAudio && !options.refText) {
+            throw new Error('refText is required when refAudio is set for voice cloning');
+        }
+        // Build the optional server params, converting camelCase to snake_case keys
+        this.serverOptions = {};
+        if (options?.refAudio != null)
+            this.serverOptions.ref_audio = options.refAudio;
+        if (options?.refText != null)
+            this.serverOptions.ref_text = options.refText;
+        if (options?.instruct != null)
+            this.serverOptions.instruct = options.instruct;
+        if (options?.gender != null)
+            this.serverOptions.gender = options.gender;
+        if (options?.pitch != null)
+            this.serverOptions.pitch = options.pitch;
+        if (options?.langCode != null)
+            this.serverOptions.lang_code = options.langCode;
+        if (options?.temperature != null)
+            this.serverOptions.temperature = options.temperature;
+        if (options?.topP != null)
+            this.serverOptions.top_p = options.topP;
+        if (options?.topK != null)
+            this.serverOptions.top_k = options.topK;
+        if (options?.repetitionPenalty != null)
+            this.serverOptions.repetition_penalty = options.repetitionPenalty;
+        if (options?.responseFormat != null)
+            this.serverOptions.response_format = options.responseFormat;
+        if (options?.stream != null)
+            this.serverOptions.stream = options.stream;
+        if (options?.streamingInterval != null)
+            this.serverOptions.streaming_interval = options.streamingInterval;
+        if (options?.maxTokens != null)
+            this.serverOptions.max_tokens = options.maxTokens;
+        if (options?.verbose != null)
+            this.serverOptions.verbose = options.verbose;
     }
     async generate(text, options) {
         if (!text?.trim())
             throw new Error('TTS text must not be empty');
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), 180_000);
+        const payload = {
+            model: this.model,
+            input: text,
+            voice: options.voice ?? 'af_heart',
+            ...this.serverOptions,
+        };
+        // TTSEngineOptions.speed maps to the server's speed field
+        if (options.speed != null) {
+            payload.speed = options.speed;
+        }
         let response;
         try {
             response = await fetch(`${this.baseUrl}/v1/audio/speech`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    model: this.model,
-                    input: text,
-                    voice: options.voice ?? 'af_heart',
-                }),
+                body: JSON.stringify(payload),
                 signal: controller.signal,
             });
         }

package/dist/tts/engines/mlx-audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"mlx-audio.js","sourceRoot":"","sources":["../../../src/tts/engines/mlx-audio.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IACjB,OAAO,CAAS;IAChB,KAAK,CAAS;IAEtB,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,uBAAuB,CAAC;QAC3D,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,mCAAmC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAyB;QACpD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAEjE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAE9D,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU;iBACnC,CAAC;gBACF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,0BAA0B,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI;gBACtD,qEAAqE,IAAI,CAAC,KAAK,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAE9D,kDAAkD;QAClD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"mlx-audio.js","sourceRoot":"","sources":["../../../src/tts/engines/mlx-audio.ts"],"names":[],"mappings":"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"}

package/dist/tts/engines/sarvam.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sarvam.d.ts","sourceRoot":"","sources":["../../../src/tts/engines/sarvam.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,CAAC,EAAE,mBAAmB;IAKzC,OAAO,CAAC,aAAa;IAWf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAsCzE"}
+{"version":3,"file":"sarvam.d.ts","sourceRoot":"","sources":["../../../src/tts/engines/sarvam.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,CAAC,EAAE,mBAAmB;IAKzC,OAAO,CAAC,aAAa;IAWf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoCzE"}

package/dist/tts/engines/sarvam.js

@@ -16,33 +16,30 @@ export class SarvamEngine {
     async generate(text, options) {
         if (!text?.trim())
             throw new Error('TTS text must not be empty');
-        const response = await fetch('https://api.sarvam.ai/text-to-speech', {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'API-Subscription-Key': this.resolveApiKey(),
-            },
-            body: JSON.stringify({
-                inputs: [text],
-                target_language_code: options.lang ?? 'hi-IN',
-                speaker: options.voice ?? 'meera',
-                model: this.model,
-                pitch: 0,
-                pace: options.speed ?? 1.0,
-                loudness: 1.5,
-                enable_preprocessing: true,
-            }),
-        });
-        if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Sarvam TTS API error ${response.status}: ${body}`);
+        let SarvamAI;
+        try {
+            // @ts-ignore — sarvamai is an optional dependency
+            ({ default: SarvamAI } = await import('sarvamai'));
+        }
+        catch {
+            throw new Error("Sarvam TTS engine requires the 'sarvamai' package. Install it with: npm i sarvamai");
         }
-        const json = await response.json();
-        if (!json.audios?.[0]) {
+        const client = new SarvamAI({ apiSubscriptionKey: this.resolveApiKey() });
+        const response = await client.textToSpeech.convert({
+            inputs: [text],
+            target_language_code: options.lang ?? 'hi-IN',
+            speaker: options.voice ?? 'meera',
+            model: this.model,
+            pitch: 0,
+            pace: options.speed ?? 1.0,
+            loudness: 1.5,
+            enable_preprocessing: true,
+        });
+        if (!response.audios?.[0]) {
             throw new Error('Sarvam TTS returned no audio data');
         }
         // Sarvam returns base64-encoded WAV
-        const audioBuffer = Buffer.from(json.audios[0], 'base64');
+        const audioBuffer = Buffer.from(response.audios[0], 'base64');
         // Convert to Argo WAV format (mono Float32 24kHz)
         const { convertToWav } = await import('../engine.js');
         return convertToWav(audioBuffer);

package/dist/tts/engines/sarvam.js.map

@@ -1 +1 @@
-{"version":3,"file":"sarvam.js","sourceRoot":"","sources":["../../../src/tts/engines/sarvam.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,OAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,WAAW,CAAC;IAC7C,CAAC;IAEO,aAAa;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,yCAAyC;gBACzC,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAyB;QACpD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,sCAAsC,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,sBAAsB,EAAE,IAAI,CAAC,aAAa,EAAE;aAC7C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM,EAAE,CAAC,IAAI,CAAC;gBACd,oBAAoB,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;gBAC7C,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;gBACjC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;gBAC1B,QAAQ,EAAE,GAAG;gBACb,oBAAoB,EAAE,IAAI;aAC3B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA2B,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,oCAAoC;QACpC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE1D,kDAAkD;QAClD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"sarvam.js","sourceRoot":"","sources":["../../../src/tts/engines/sarvam.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,OAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,WAAW,CAAC;IAC7C,CAAC;IAEO,aAAa;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,yCAAyC;gBACzC,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAyB;QACpD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAEjE,IAAI,QAAa,CAAC;QAClB,IAAI,CAAC;YACH,kDAAkD;YAClD,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;YACjD,MAAM,EAAE,CAAC,IAAI,CAAC;YACd,oBAAoB,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;YAC7C,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;YAC1B,QAAQ,EAAE,GAAG;YACb,oBAAoB,EAAE,IAAI;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,oCAAoC;QACpC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE9D,kDAAkD;QAClD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@argo-video/cli",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Turn Playwright demo scripts into polished product demo videos with AI voiceover",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,6 +29,12 @@
     "commander": "^12.0.0",
     "kokoro-js": "^1.2.1"
   },
+  "optionalDependencies": {
+    "openai": "^4.0.0",
+    "elevenlabs": "^1.0.0",
+    "@google/genai": "^1.0.0",
+    "sarvamai": "^1.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +45,8 @@
   "license": "MIT",
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "scripts"
   ],
   "devDependencies": {
     "@playwright/test": "^1.50.0",

package/scripts/generate_logo_thumbnail.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from pathlib import Path
+import random
+
+from PIL import Image, ImageDraw, ImageFilter, ImageFont
+
+
+ROOT = Path(__file__).resolve().parents[1]
+ASSETS = ROOT / "assets"
+OUTPUT_PATH = ASSETS / "logo-thumb.png"
+SOURCE_MARK_PATH = ASSETS / "logo-mark-source.png"
+
+WIDTH = 1920
+HEIGHT = 1080
+
+MONO_FONT = "/System/Library/Fonts/SFNSMono.ttf"
+DISPLAY_BOLD = "/Library/Fonts/SF-Compact-Display-Bold.otf"
+
+
+def load_font(path: str, size: int) -> ImageFont.FreeTypeFont:
+    return ImageFont.truetype(path, size=size)
+
+
+def normalize_mark() -> Image.Image:
+    if SOURCE_MARK_PATH.exists():
+        return Image.open(SOURCE_MARK_PATH).convert("RGBA")
+
+    original = Image.open(OUTPUT_PATH).convert("RGBA")
+    mark = Image.new("RGBA", original.size, (0, 0, 0, 0))
+    in_px = original.load()
+    out_px = mark.load()
+
+    for y in range(original.height):
+        for x in range(original.width):
+            r, g, b, _ = in_px[x, y]
+            if b > 150 and g > 110 and r < 140:
+                out_px[x, y] = (107, 180, 255, 255)
+
+    bbox = mark.getbbox()
+    if bbox is None:
+        raise RuntimeError("Could not isolate source logo mark")
+
+    cropped = mark.crop(bbox)
+    cropped.save(SOURCE_MARK_PATH)
+    return cropped
+
+
+def lerp(a: int, b: int, t: float) -> int:
+    return int(a + (b - a) * t)
+
+
+def make_background() -> Image.Image:
+    image = Image.new("RGBA", (WIDTH, HEIGHT), (0, 0, 0, 255))
+    px = image.load()
+
+    top_left = (8, 10, 18)
+    bottom_right = (18, 22, 37)
+    top_right = (12, 14, 26)
+
+    for y in range(HEIGHT):
+        ty = y / (HEIGHT - 1)
+        for x in range(WIDTH):
+            tx = x / (WIDTH - 1)
+            r = lerp(lerp(top_left[0], top_right[0], tx), bottom_right[0], ty)
+            g = lerp(lerp(top_left[1], top_right[1], tx), bottom_right[1], ty)
+            b = lerp(lerp(top_left[2], top_right[2], tx), bottom_right[2], ty)
+            px[x, y] = (r, g, b, 255)
+
+    return image
+
+
+def add_radial_glow(base: Image.Image, center: tuple[int, int], radius: int, color: tuple[int, int, int], alpha: int, blur: int) -> None:
+    layer = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    draw = ImageDraw.Draw(layer)
+    x, y = center
+    draw.ellipse((x - radius, y - radius, x + radius, y + radius), fill=color + (alpha,))
+    layer = layer.filter(ImageFilter.GaussianBlur(blur))
+    base.alpha_composite(layer)
+
+
+def add_grid(base: Image.Image) -> None:
+    grid = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    draw = ImageDraw.Draw(grid)
+
+    for x in range(120, WIDTH, 96):
+        draw.line((x, 0, x, HEIGHT), fill=(92, 126, 188, 14), width=1)
+    for y in range(96, HEIGHT, 96):
+        draw.line((0, y, WIDTH, y), fill=(92, 126, 188, 10), width=1)
+
+    random.seed(7)
+    for _ in range(240):
+        x = random.randint(0, WIDTH - 1)
+        y = random.randint(0, HEIGHT - 1)
+        draw.point((x, y), fill=(160, 185, 255, random.randint(10, 28)))
+
+    base.alpha_composite(grid)
+
+
+def draw_mark(base: Image.Image, mark: Image.Image) -> None:
+    mark = mark.resize((1440, int(mark.height * (1440 / mark.width))), Image.Resampling.LANCZOS)
+
+    glow = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    glow_mark = mark.copy()
+    glow_mark = glow_mark.filter(ImageFilter.GaussianBlur(14))
+    gx = (WIDTH - glow_mark.width) // 2
+    gy = 200
+    glow.alpha_composite(glow_mark, (gx, gy))
+
+    tint = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    tint_draw = ImageDraw.Draw(tint)
+    tint_draw.ellipse((420, 220, 1500, 760), fill=(71, 136, 255, 30))
+    tint = tint.filter(ImageFilter.GaussianBlur(54))
+
+    base.alpha_composite(tint)
+    base.alpha_composite(glow, (0, 0))
+
+    mark_shadow = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    shadow = mark.copy().filter(ImageFilter.GaussianBlur(18))
+    mark_shadow.alpha_composite(shadow, (gx, gy + 8))
+    base.alpha_composite(mark_shadow)
+    base.alpha_composite(mark, (gx, gy))
+
+
+def draw_command_card(base: Image.Image) -> None:
+    card = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    draw = ImageDraw.Draw(card)
+
+    x0, y0, x1, y1 = 500, 760, 1420, 892
+    shadow = Image.new("RGBA", base.size, (0, 0, 0, 0))
+    ImageDraw.Draw(shadow).rounded_rectangle((x0, y0 + 18, x1, y1 + 18), radius=34, fill=(0, 0, 0, 120))
+    shadow = shadow.filter(ImageFilter.GaussianBlur(24))
+    base.alpha_composite(shadow)
+
+    draw.rounded_rectangle((x0, y0, x1, y1), radius=34, fill=(14, 18, 30, 228), outline=(97, 127, 183, 88), width=2)
+    draw.rounded_rectangle((x0 + 2, y0 + 2, x1 - 2, y0 + 38), radius=32, fill=(18, 23, 38, 245))
+
+    button_y = y0 + 20
+    for idx, color in enumerate(((255, 95, 86), (255, 189, 46), (39, 201, 63))):
+        bx = x0 + 30 + idx * 22
+        draw.ellipse((bx, button_y, bx + 12, button_y + 12), fill=color)
+
+    mono = load_font(MONO_FONT, 40)
+    small = load_font(MONO_FONT, 24)
+
+    prompt_y = y0 + 64
+    draw.text((x0 + 34, prompt_y), "$", font=mono, fill=(123, 217, 129))
+    draw.text((x0 + 72, prompt_y), "npx argo", font=mono, fill=(110, 187, 255))
+    draw.text((x0 + 330, prompt_y), "pipeline", font=mono, fill=(233, 239, 252))
+    draw.text((x0 + 566, prompt_y), "showcase", font=mono, fill=(169, 146, 255))
+
+    note = "local-first  •  webkit-friendly  •  retina-ready"
+    note_box = draw.textbbox((0, 0), note, font=small)
+    note_x = (WIDTH - (note_box[2] - note_box[0])) / 2
+    draw.text((note_x, y1 + 24), note, font=small, fill=(100, 121, 160))
+
+    base.alpha_composite(card)
+
+
+def main() -> None:
+    ASSETS.mkdir(exist_ok=True)
+    mark = normalize_mark()
+    image = make_background()
+    add_radial_glow(image, (WIDTH // 2, 420), 420, (48, 99, 235), 48, 96)
+    add_radial_glow(image, (1470, 210), 220, (41, 91, 235), 42, 84)
+    add_radial_glow(image, (360, 910), 300, (43, 74, 170), 34, 92)
+    add_grid(image)
+    draw_mark(image, mark)
+    draw_command_card(image)
+    image.convert("RGB").save(OUTPUT_PATH, quality=95)
+
+
+if __name__ == "__main__":
+    main()

package/scripts/record-voice-ref.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+#
+# Record and process a voice reference clip for mlx-audio voice cloning.
+# Usage: ./scripts/record-voice-ref.sh [output_path]
+#
+# Requirements: ffmpeg (brew install ffmpeg), macOS with built-in mic
+#
+set -euo pipefail
+
+OUTPUT="${1:-assets/ref-voice.wav}"
+RAW_FILE=$(mktemp /tmp/voice-ref-raw.XXXXXX.wav)
+
+# Suggested text — covers a wide range of English phonemes
+cat <<'PROMPT'
+╔══════════════════════════════════════════════════════════════════╗
+║  Voice Reference Recording                                      ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                  ║
+║  Read the following text naturally, at your demo narration pace: ║
+║                                                                  ║
+║  "Hi, my name is [YOUR NAME]. I build developer tools and love   ║
+║   creating great product demos. The quick brown fox jumps over   ║
+║   the lazy dog. Pack my box with five dozen liquor jugs."        ║
+║                                                                  ║
+║  Tips:                                                           ║
+║   • Sit ~6 inches from the mic                                   ║
+║   • Use a quiet room (close windows, turn off fans)              ║
+║   • Speak clearly at your natural pace                           ║
+║   • Aim for 5–15 seconds                                         ║
+║                                                                  ║
+╚══════════════════════════════════════════════════════════════════╝
+
+PROMPT
+
+echo "Press ENTER to start recording (Ctrl+C to cancel)..."
+read -r
+
+echo "🎙  Recording... Press Ctrl+C when done."
+
+# Record using macOS Core Audio (avfoundation) via ffmpeg
+# Uses the default input device (built-in mic or whatever is selected in
+# System Settings > Sound > Input)
+ffmpeg -y -f avfoundation -i ":default" \
+  -acodec pcm_s16le -ar 44100 -ac 1 \
+  "$RAW_FILE" 2>/dev/null || true
+
+echo ""
+echo "Processing audio..."
+
+# Get duration
+DURATION=$(ffprobe -v error -show_entries format=duration \
+  -of csv=p=0 "$RAW_FILE" 2>/dev/null || echo "0")
+
+if [ "$DURATION" = "0" ] || [ "$(echo "$DURATION < 2" | bc -l 2>/dev/null || echo 0)" = "1" ]; then
+  echo "Error: Recording too short or failed. Try again."
+  rm -f "$RAW_FILE"
+  exit 1
+fi
+
+# Create output directory if needed
+mkdir -p "$(dirname "$OUTPUT")"
+
+# Process: mono, 24kHz, noise-reduced, normalized
+ffmpeg -y -i "$RAW_FILE" \
+  -af "highpass=f=80,lowpass=f=12000,afftdn=nf=-25,loudnorm=I=-16:TP=-1.5:LRA=11" \
+  -ar 24000 -ac 1 -acodec pcm_s16le \
+  "$OUTPUT" 2>/dev/null
+
+rm -f "$RAW_FILE"
+
+FINAL_DURATION=$(ffprobe -v error -show_entries format=duration \
+  -of csv=p=0 "$OUTPUT" 2>/dev/null)
+
+echo ""
+echo "Done! Saved to: $OUTPUT (${FINAL_DURATION}s)"
+echo ""
+echo "Next steps:"
+echo "  1. Listen: ffplay $OUTPUT"
+echo "  2. Add to your argo config:"
+echo ""
+echo "     tts: {"
+echo "       engine: engines.mlxAudio({"
+echo "         model: 'mlx-community/Qwen3-TTS-12Hz-0.6B-Base-bf16',"
+echo "         refAudio: './$OUTPUT',"
+echo "         refText: 'YOUR EXACT TRANSCRIPT HERE',"
+echo "       }),"
+echo "     }"

package/scripts/setup-mlx-audio.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+#
+# Set up mlx-audio with all dependencies for Argo voice cloning.
+# Usage: ./scripts/setup-mlx-audio.sh
+#
+# Creates a .venv in the project root with mlx-audio and its
+# transitive deps that aren't auto-installed.
+#
+set -euo pipefail
+
+VENV_DIR="${1:-.venv}"
+
+echo "╔══════════════════════════════════════════════╗"
+echo "║  Argo — mlx-audio setup (Apple Silicon)      ║"
+echo "╚══════════════════════════════════════════════╝"
+echo ""
+
+# Check for uv
+if ! command -v uv &>/dev/null; then
+  echo "✗ uv not found. Install it: curl -LsSf https://astral.sh/uv/install.sh | sh"
+  exit 1
+fi
+
+# Check for Apple Silicon
+if [[ "$(uname -m)" != "arm64" ]]; then
+  echo "! Warning: mlx-audio is optimized for Apple Silicon (arm64)."
+  echo "  Current arch: $(uname -m). Performance may be poor."
+fi
+
+# Create venv
+echo "★ Creating venv at ${VENV_DIR}..."
+uv venv "$VENV_DIR"
+
+# Install mlx-audio + missing transitive deps
+echo "★ Installing mlx-audio..."
+uv pip install -p "$VENV_DIR" mlx-audio
+
+echo "★ Installing missing transitive dependencies..."
+uv pip install -p "$VENV_DIR" "misaki[en]" num2words pip
+
+# setuptools < 70 needed for webrtcvad's pkg_resources import
+echo "★ Installing setuptools (< 70 for pkg_resources compat)..."
+uv pip install -p "$VENV_DIR" "setuptools<70"
+
+# Server deps (for OpenAI-compatible HTTP API)
+echo "★ Installing server dependencies..."
+uv pip install -p "$VENV_DIR" uvicorn fastapi python-multipart webrtcvad
+
+echo ""
+echo "✓ Done! mlx-audio installed at ${VENV_DIR}"
+echo ""
+echo "Usage:"
+echo "  # Start the TTS server"
+echo "  ${VENV_DIR}/bin/python3 -m mlx_audio.server --port 8000"
+echo ""
+echo "  # Record a voice reference clip"
+echo "  ./scripts/record-voice-ref.sh assets/ref-voice.wav"
+echo ""
+echo "  # Preview cloned voice"
+echo "  ./scripts/voice-clone-preview.sh \\"
+echo "    --ref-audio assets/ref-voice.wav \\"
+echo "    --ref-text 'Your transcript here.' \\"
+echo "    --voiceover demos/showcase.voiceover.json --play"
+echo ""
+echo "  # Use in argo config"
+echo "  engines.mlxAudio({ model: 'mlx-community/Qwen3-TTS-12Hz-0.6B-Base-bf16' })"