reelforge 0.4.2 → 0.5.0

package/README.md

@@ -44,7 +44,7 @@ That's the whole story — no server to run.
 
 ### Self-hosting
 
-If you want to run your own ReelForge Studio (own LLM / RunningHub keys, your own pricing) clone the upstream repo, `pnpm dev`, then point the CLI at it:
+If you want to run your own ReelForge Studio (own RelayX key, your own pricing) clone the upstream repo, `pnpm dev`, then point the CLI at it:
 
 ```bash
 rf --server http://localhost:8501 health
@@ -72,13 +72,12 @@ Run `rf <command> --help` for full details on any of these.
 
 | command | what it does |
 |---|---|
-| `llm chat -p <text>` | Send one prompt to the configured LLM |
-| `llm presets` | List built-in provider presets |
-| `tts edge -t <text> -o out.mp3` | Local Edge TTS synthesis |
-| `tts workflow -t <text> -w <workflow>` | ComfyUI TTS workflow (clone-style, IndexTTS etc.) |
+| `llm chat -p <text>` | Send one prompt to the configured LLM (RelayX gateway by default) |
+| `llm presets` | List built-in RelayX model presets |
+| `tts edge -t <text> -o out.mp3` | Local Edge TTS synthesis (free) |
+| `tts relayx -t <text> -o out.mp3` | RelayX TTS (vox/index-tts-2, 149 built-in voices) |
 | `tts voices [--locale zh]` | List supported Edge TTS voices |
-| `images generate -p <prompt> -w <workflow>` | Image generation via ComfyUI / RunningHub |
-| `images analyze -i <image>` | Reverse-describe an image |
+| `images generate -p <prompt> -m rx-image-flux` | Image generation via RelayX (rx-image-z / rx-image-flux / rx-image-qwen) |
 
 ### Content generation
 
@@ -114,7 +113,6 @@ All `pipelines *` commands submit an **async task** and (by default) poll until
 
 | command | what it does |
 |---|---|
-| `workflows list [--source runninghub] [--kind image]` | Browse ComfyUI workflows |
 | `bgm list / upload <file> / delete <name>` | Manage background music |
 | `files list / upload <file> / download <path> / delete <path>` | Manage user assets |
 
@@ -148,12 +146,12 @@ rf tasks list --limit 5
 rf history get <task-id> --download recovered.mp4
 
 # 4. JSON pipe for automation
-rf workflows list --kind image --json | jq '.workflows[].key'
+rf llm presets --json | jq '.[].defaultModel'
 
 # 5. Configure & test LLM (self-hosted)
-rf config set llm.api_key sk-xxxxx
-rf config set llm.base_url https://dashscope.aliyuncs.com/compatible-mode/v1
-rf config set llm.model qwen-plus
+rf config set llm.api_key rx-xxxxx          # RelayX key (or your own provider key)
+rf config set llm.base_url https://relayx.timor419.com/v1
+rf config set llm.model anthropic/claude-4-7-sonnet
 rf llm chat -p 'one-sentence summary of antifragile'
 ```
 

package/dist/commands/config.js

@@ -4,7 +4,7 @@ import { print } from "../utils/output.js";
 export function registerConfig(program) {
     const cfg = program
         .command("config")
-        .description("Read or update the server config.yaml (LLM / ComfyUI / RunningHub keys)")
+        .description("Read or update the server config.yaml (LLM / RelayX keys)")
         .helpOption("-h, --help", "show help");
     cfg
         .command("get")
@@ -22,10 +22,10 @@ export function registerConfig(program) {
         "",
         "Examples:",
         "  reelforge config set llm.api_key sk-xxxxxx",
-        "  reelforge config set llm.base_url https://dashscope.aliyuncs.com/compatible-mode/v1",
-        "  reelforge config set llm.model qwen-plus",
-        "  reelforge config set comfyui.runninghub_api_key rh-xxxxxx",
-        "  reelforge config set comfyui.runninghub_instance_type plus",
+        "  reelforge config set llm.base_url https://relayx.timor419.com/v1",
+        "  reelforge config set llm.model openai/gpt-5-mini",
+        "  reelforge config set relayx.api_key rx-xxxxxx",
+        "  reelforge config set relayx.default_image_model rx-image-flux",
     ].join("\n"))
         .action(async (key, value) => {
         const parts = key.split(".");

package/dist/commands/create.js

@@ -7,18 +7,8 @@ import { downloadTo } from "../utils/download.js";
 import { info, print, success, warn } from "../utils/output.js";
 const LAST_CREATE_PATH = path.join(os.homedir(), ".reelforge", "last-create.json");
 // ── Cost estimation (mirrors server src/lib/billing.ts) ──────────
-function calcWorkflowUnits(wfKey) {
-    if (!wfKey)
-        return 3;
-    const base = (wfKey.split("/").pop() || wfKey).toLowerCase();
-    if (base.startsWith("tts_"))
-        return 1;
-    if (base.startsWith("image_"))
-        return 3;
-    if (base.startsWith("analyse_") || base.startsWith("analyze_"))
-        return 2;
-    return 3;
-}
+const IMAGE_UNITS = 3; // matches ATOMIC_UNITS["images.generate"] in src/lib/billing.ts
+const TTS_RELAYX_UNITS = 1; // matches ATOMIC_UNITS["tts.relayx"]
 function estimateUnits(body) {
     const mode = body.mode || "generate";
     const titleExplicit = !!body.title;
@@ -31,12 +21,9 @@ function estimateUnits(body) {
         : tplBase.startsWith("asset_")
             ? "asset"
             : "image";
-    let mediaPerFrame = 0;
-    if (tplType === "image") {
-        mediaPerFrame = body.media_workflow ? calcWorkflowUnits(body.media_workflow) : 3;
-    }
-    const ttsMode = body.tts_inference_mode || (body.tts_workflow ? "comfyui" : "local");
-    const ttsPerFrame = ttsMode === "comfyui" ? 1 : 0;
+    const mediaPerFrame = tplType === "image" ? IMAGE_UNITS : 0;
+    const ttsMode = body.tts_inference_mode || "edge";
+    const ttsPerFrame = ttsMode === "relayx" ? TTS_RELAYX_UNITS : 0;
     const narrations = mode === "generate" ? 1 : 0;
     const title = titleExplicit ? 0 : 1;
     const imagePrompts = tplType === "static" ? 0 : 1;
@@ -147,14 +134,10 @@ function optsToBody(opts) {
         out.tts_voice = opts.ttsVoice;
     if (opts.voiceId !== undefined)
         out.voice_id = opts.voiceId;
-    if (opts.ttsWorkflow !== undefined)
-        out.tts_workflow = opts.ttsWorkflow;
     if (opts.ttsSpeed !== undefined)
         out.tts_speed = opts.ttsSpeed;
-    if (opts.refAudio !== undefined)
-        out.ref_audio = opts.refAudio;
-    if (opts.mediaWorkflow !== undefined)
-        out.media_workflow = opts.mediaWorkflow;
+    if (opts.imageModel !== undefined)
+        out.image_model = opts.imageModel;
     if (opts.frameTemplate !== undefined)
         out.frame_template = opts.frameTemplate;
     if (opts.promptPrefix !== undefined)
@@ -313,16 +296,14 @@ export function registerCreate(program) {
         .option("--max-image-prompt-words <N>", "image prompt max words", (v) => parseInt(v, 10))
         // --- Visual ---
         .option("--frame-template <key>", "HTML frame template, e.g. 1080x1920/image_default.html")
-        .option("--media-workflow <key>", "AI image/video workflow, e.g. runninghub/image_flux.json")
+        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen)")
         .option("--prompt-prefix <text>", "raw style prefix prepended to every image prompt (overrides --style)")
         .option("--style <preset>", "image style preset — shortcut for --prompt-prefix; see 'Style presets' below for the full list")
         // --- Audio (TTS) ---
-        .option("--tts-voice <id>", "Edge TTS voice id, e.g. zh-CN-YunjianNeural / en-US-AriaNeural")
+        .option("--tts-voice <id>", "TTS voice id; for edge use e.g. zh-CN-YunjianNeural / en-US-AriaNeural; for relayx use vox voice ids (default: 专业解说)")
         .option("--tts-speed <n>", "speech speed 0.5..2", parseFloat)
-        .option("--tts-inference-mode <mode>", "local | comfyui")
-        .option("--tts-workflow <key>", "ComfyUI TTS workflow (forces inference-mode=comfyui)")
+        .option("--tts-inference-mode <mode>", "edge (default, local Microsoft Edge TTS) | relayx (vox/index-tts-2 via RelayX)")
         .option("--voice-id <id>", "alias of --tts-voice (legacy compat)")
-        .option("--ref-audio <path>", "reference audio for voice-cloning TTS workflows")
         // --- Audio (BGM) ---
         .option("--bgm <path>", "background music file path (server-side relative to bgm/)")
         .option("--bgm-volume <n>", "BGM volume 0..1", parseFloat)
@@ -354,8 +335,8 @@ export function registerCreate(program) {
         "",
         "Param groups:",
         "  Content : --mode --title -n --split-mode --min/max-narration-words --min/max-image-prompt-words",
-        "  Visual  : --frame-template --media-workflow --style --prompt-prefix",
-        "  TTS     : --tts-voice --tts-speed --tts-inference-mode --tts-workflow --voice-id --ref-audio",
+        "  Visual  : --frame-template --image-model --style --prompt-prefix",
+        "  TTS     : --tts-voice --tts-speed --tts-inference-mode --voice-id",
         "  BGM     : --bgm --bgm-volume --bgm-mode",
         "  Output  : --video-fps --template-params -o --no-download --no-wait --poll-ms --timeout-ms",
         "  Workflow: --recipe --redo --dry-run",
@@ -373,8 +354,6 @@ export function registerCreate(program) {
         "",
         "Explore available resources (separate commands):",
         "  reelforge templates list                  # all HTML templates",
-        "  reelforge workflows list --kind image     # all AI image workflows",
-        "  reelforge workflows list --kind video     # all AI video workflows",
         "  reelforge tts voices --locale zh          # Edge TTS voice ids",
         "  reelforge bgm list                        # built-in BGM files",
         "",
@@ -427,7 +406,7 @@ export function registerCreate(program) {
         '    "text": "为什么我们还没找到外星文明？",',
         '    "n_scenes": 7,',
         '    "frame_template": "1080x1920/image_default.html",',
-        '    "media_workflow": "runninghub/image_flux.json",',
+        '    "image_model": "rx-image-flux",',
         '    "prompt_prefix": "Minimalist matchstick figure style",',
         '    "tts_voice": "zh-CN-YunjianNeural",',
         '    "tts_speed": 1.2,',

package/dist/commands/images.js

@@ -4,42 +4,32 @@ import { print, success } from "../utils/output.js";
 export function registerImages(program) {
     const images = program
         .command("images")
-        .description("Image generation and analysis via ComfyUI / RunningHub workflows")
+        .description("Image generation via RelayX (rx-image-z / rx-image-flux / rx-image-qwen)")
         .helpOption("-h, --help", "show help");
     images
         .command("generate")
-        .description("Generate an image via a ComfyUI image_* workflow")
+        .description("Generate an image via RelayX")
         .helpOption("-h, --help", "show help")
         .requiredOption("-p, --prompt <text>", "text prompt")
-        .requiredOption("-w, --workflow <key>", "workflow key, e.g. selfhost/image_flux.json")
+        .option("-m, --model <id>", "RelayX image model id (rx-image-z | rx-image-flux | rx-image-qwen)")
         .option("--width <n>", "image width", parseInt)
         .option("--height <n>", "image height", parseInt)
-        .option("--steps <n>", "sampling steps", parseInt)
-        .option("--seed <n>", "random seed", parseInt)
-        .option("--cfg <n>", "CFG scale", parseFloat)
-        .option("--negative <text>", "negative prompt")
         .option("-o, --output <file>", "download first image to this local path")
         .option("--all-output <dir>", "download ALL generated images into this directory")
         .addHelpText("after", [
         "",
         "Examples:",
-        "  reelforge images generate -p 'a cat' -w selfhost/image_flux.json --width 1024 --height 1024 -o cat.png",
-        "  reelforge images generate -p 'cyberpunk city' -w runninghub/image_qwen.json --seed 42 -o city.png",
+        "  reelforge images generate -p 'a cat' -m rx-image-flux --width 1024 --height 1024 -o cat.png",
+        "  reelforge images generate -p 'cyberpunk city, neon, 9:16' --width 1080 --height 1920 -o city.png",
     ].join("\n"))
         .action(async (opts) => {
-        const body = { prompt: opts.prompt, workflow: opts.workflow };
+        const body = { prompt: opts.prompt };
+        if (opts.model)
+            body.model = opts.model;
         if (opts.width !== undefined)
             body.width = opts.width;
         if (opts.height !== undefined)
             body.height = opts.height;
-        if (opts.steps !== undefined)
-            body.steps = opts.steps;
-        if (opts.seed !== undefined)
-            body.seed = opts.seed;
-        if (opts.cfg !== undefined)
-            body.cfg = opts.cfg;
-        if (opts.negative)
-            body.negative_prompt = opts.negative;
         const r = await post("/api/v1/images/generate", body);
         if (opts.output && r.images?.[0]) {
             await downloadTo(r.images[0], opts.output);
@@ -54,14 +44,4 @@ export function registerImages(program) {
         }
         print(r);
     });
-    images
-        .command("analyze")
-        .description("Reverse-describe an image using an analyse_image workflow")
-        .helpOption("-h, --help", "show help")
-        .requiredOption("-i, --image <pathOrUrl>", "image to analyze (local path or URL)")
-        .option("-w, --workflow <key>", "workflow key", "selfhost/analyse_image.json")
-        .action(async (opts) => {
-        const r = await post("/api/v1/images/analyze", { image: opts.image, workflow: opts.workflow });
-        print(r);
-    });
 }

package/dist/commands/llm.js

@@ -4,7 +4,7 @@ import { print, table } from "../utils/output.js";
 export function registerLlm(program) {
     const llm = program
         .command("llm")
-        .description("Large-language-model utilities (chat, list providers)")
+        .description("Large-language-model utilities (chat, list RelayX model presets)")
         .helpOption("-h, --help", "show help");
     llm
         .command("chat")
@@ -21,7 +21,7 @@ export function registerLlm(program) {
         "",
         "Examples:",
         "  reelforge llm chat -p 'Hello'",
-        "  reelforge llm chat -p @prompt.txt -m qwen-plus -t 0.4",
+        "  reelforge llm chat -p @prompt.txt -m anthropic/claude-4-7-sonnet -t 0.4",
         "  reelforge llm chat -p 'movie review of Inception' --schema review.json --json",
     ].join("\n"))
         .action(async (opts) => {
@@ -47,7 +47,7 @@ export function registerLlm(program) {
     });
     llm
         .command("presets")
-        .description("List built-in LLM provider presets (Qwen / OpenAI / Claude / DeepSeek / Ollama / Moonshot)")
+        .description("List built-in RelayX model presets (GPT-5 / Claude 4.7 / Gemini 3 / DeepSeek / Qwen / Kimi)")
         .helpOption("-h, --help", "show help")
         .action(async () => {
         const r = await get("/api/v1/llm/presets");

package/dist/commands/pipelines.js

@@ -47,7 +47,7 @@ export function registerPipelines(program) {
         .option("-n, --n-scenes <n>", "number of scenes (mode=generate)", parseInt, 5)
         .option("--split-mode <mode>", "paragraph | line | sentence (mode=fixed)", "paragraph")
         .option("--frame-template <key>", "template, e.g. 1080x1920/static_default.html", "1080x1920/static_default.html")
-        .option("--media-workflow <key>", "ComfyUI workflow for AI image/video (when template requires it)")
+        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen) — only when template requires AI images")
         .option("--prompt-prefix <text>", "style prefix prepended to image prompts")
         .option("--tts-voice <id>", "Edge TTS voice", "zh-CN-YunjianNeural")
         .option("--tts-speed <n>", "speech speed (0.5..2)", parseFloat, 1.2)
@@ -58,7 +58,7 @@ export function registerPipelines(program) {
         "Examples:",
         "  reelforge pipelines standard -t 'why we explore space' -n 5 -o space.mp4",
         "  reelforge pipelines standard -t @script.txt --mode fixed --split-mode paragraph --title 'My Show' -o out.mp4",
-        "  reelforge pipelines standard -t '宠物' --frame-template 1080x1920/image_default.html --media-workflow runninghub/image_flux.json --prompt-prefix 'cinematic'",
+        "  reelforge pipelines standard -t '宠物' --frame-template 1080x1920/image_default.html --image-model rx-image-flux --prompt-prefix 'cinematic'",
     ].join("\n"))).action(async (opts) => {
         let text = opts.text;
         if (text.startsWith("@"))
@@ -70,7 +70,7 @@ export function registerPipelines(program) {
             n_scenes: opts.nScenes,
             split_mode: opts.splitMode,
             frame_template: opts.frameTemplate,
-            media_workflow: opts.mediaWorkflow,
+            image_model: opts.imageModel,
             prompt_prefix: opts.promptPrefix,
             tts_voice: opts.ttsVoice,
             tts_speed: opts.ttsSpeed,

package/dist/commands/tts.js

@@ -4,7 +4,7 @@ import { print, table, success } from "../utils/output.js";
 export function registerTts(program) {
     const tts = program
         .command("tts")
-        .description("Text-to-speech: local Edge TTS or ComfyUI workflow")
+        .description("Text-to-speech: local Edge TTS (free) or RelayX vox/index-tts-2")
         .helpOption("-h, --help", "show help");
     tts
         .command("edge")
@@ -37,32 +37,31 @@ export function registerTts(program) {
         print({ ok: r.ok, voice: r.voice, rate: r.rate, size_bytes: r.size_bytes, file_path: r.file_path, url: r.url, downloaded_to: opts.output || null });
     });
     tts
-        .command("workflow")
-        .description("Synthesize speech via a ComfyUI TTS workflow (e.g. IndexTTS, SparkTTS)")
+        .command("relayx")
+        .description("Synthesize speech via RelayX (vox/index-tts-2 by default; 149 built-in voices)")
         .helpOption("-h, --help", "show help")
         .requiredOption("-t, --text <text>", "text to synthesize")
-        .requiredOption("-w, --workflow <key>", "workflow key, e.g. runninghub/tts_index2.json")
-        .option("--voice <id>", "voice ID (workflow-specific)")
-        .option("--speed <n>", "speech speed multiplier", parseFloat)
-        .option("--ref-audio <path>", "reference audio (URL or local path) for clone-style workflows")
+        .option("-m, --model <id>", "RelayX TTS model id (default: vox/index-tts-2)")
+        .option("--voice <id>", "voice id within the model (vox default: 专业解说)")
+        .option("--speed <n>", "speech speed multiplier (0.5..2)", parseFloat)
         .option("-o, --output <file>", "download audio to this local path")
         .addHelpText("after", [
         "",
         "Example:",
-        "  reelforge tts workflow -t 'hello' -w runninghub/tts_index2.json --ref-audio data/uploads/me.wav -o me.mp3",
+        "  reelforge tts relayx -t '你好世界' --voice '专业解说' -o hello.mp3",
     ].join("\n"))
         .action(async (opts) => {
-        const body = { text: opts.text, workflow: opts.workflow };
+        const body = { text: opts.text };
+        if (opts.model)
+            body.model = opts.model;
         if (opts.voice)
             body.voice = opts.voice;
         if (opts.speed !== undefined)
             body.speed = opts.speed;
-        if (opts.refAudio)
-            body.ref_audio = opts.refAudio;
-        const r = await post("/api/v1/tts/workflow", body);
-        if (opts.output && r.audio_url) {
-            await downloadTo(r.audio_url, opts.output);
-            success(`Saved → ${opts.output}`);
+        const r = await post("/api/v1/tts/relayx", body);
+        if (opts.output) {
+            await downloadTo(r.url, opts.output);
+            success(`Saved → ${opts.output} (${r.size_bytes} bytes, model=${r.model}, voice=${r.voice})`);
         }
         print(r);
     });

package/dist/index.js

@@ -22,7 +22,6 @@ import { registerTemplates } from "./commands/templates.js";
 import { registerFrames } from "./commands/frames.js";
 import { registerCompositions } from "./commands/compositions.js";
 import { registerPipelines } from "./commands/pipelines.js";
-import { registerWorkflows } from "./commands/workflows.js";
 import { registerBgm } from "./commands/bgm.js";
 import { registerFiles } from "./commands/files.js";
 import { registerTasks } from "./commands/tasks.js";
@@ -69,7 +68,7 @@ program.addHelpText("afterAll", [
     "  rf create '...' -o ./videos/space.mp4                # pick the exact path",
     "  rf llm chat --prompt 'explain antifragile in 3 sentences'",
     "  rf tts edge --text 'hello world' --voice en-US-AriaNeural -o out.mp3",
-    "  rf images generate --prompt 'a cat' --workflow selfhost/image_flux.json -o cat.png",
+    "  rf images generate --prompt 'a cat' --model rx-image-flux -o cat.png",
     "  rf pipelines standard --text 'why we explore space' --tts-voice zh-CN-YunjianNeural",
     "  rf tasks list --status running",
     "  rf config get",
@@ -84,7 +83,6 @@ registerTemplates(program);
 registerFrames(program);
 registerCompositions(program);
 registerPipelines(program);
-registerWorkflows(program);
 registerBgm(program);
 registerFiles(program);
 registerTasks(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelforge",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "CLI for ReelForge Studio — AI video engine. Installs as both `reelforge` and the short alias `rf`. Every REST API exposed as a command, with --help on every level.",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,8 +35,7 @@
   "keywords": [
     "reelforge",
     "ai-video",
-    "comfyui",
-    "runninghub",
+    "relayx",
     "tts",
     "edge-tts",
     "ffmpeg",

package/dist/commands/workflows.js

@@ -1,29 +0,0 @@
-import { get } from "../client.js";
-import { table } from "../utils/output.js";
-export function registerWorkflows(program) {
-    const wf = program
-        .command("workflows")
-        .alias("workflow")
-        .description("Browse ComfyUI / RunningHub workflows under workflows/")
-        .helpOption("-h, --help", "show help");
-    wf
-        .command("list")
-        .description("List all available workflows")
-        .helpOption("-h, --help", "show help")
-        .option("--source <src>", "filter by source: selfhost | runninghub")
-        .option("--kind <kind>", "filter by kind: image | tts | analyse")
-        .action(async (opts) => {
-        const qs = new URLSearchParams();
-        if (opts.source)
-            qs.set("source", opts.source);
-        if (opts.kind)
-            qs.set("kind", opts.kind);
-        const r = await get(`/api/v1/workflows${qs.toString() ? `?${qs}` : ""}`);
-        table(r.workflows.map((w) => ({
-            key: w.key,
-            source: w.source,
-            kind: w.kind,
-            workflow_id: w.workflow_id || "-",
-        })));
-    });
-}