@merpuya/falgen-cli 0.1.0

package/dist/falgen.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+// src/falgen.ts
+import { pathToFileURL } from "url";
+import { Command } from "commander";
+
+// src/commands/auth.ts
+import { setKey } from "@merpuya/falgen";
+async function runAuthSet(key) {
+  const path = await setKey(key);
+  console.log(`wrote ${path}`);
+}
+
+// src/commands/gen.ts
+import { generate } from "@merpuya/falgen";
+function buildGenerateInput(prompt, flags) {
+  const input = { prompt };
+  if (flags.spec !== void 0) input.spec = flags.spec;
+  if (flags.model !== void 0) input.model = flags.model;
+  if (flags.width !== void 0) input.width = flags.width;
+  if (flags.height !== void 0) input.height = flags.height;
+  if (flags.steps !== void 0) input.steps = flags.steps;
+  if (flags.guidance !== void 0) input.guidance = flags.guidance;
+  if (flags.seed !== void 0) input.seed = flags.seed;
+  if (flags.numImages !== void 0) input.numImages = flags.numImages;
+  const output = {};
+  if (flags.out !== void 0) output.dir = flags.out;
+  if (flags.sidecar !== void 0) output.sidecar = flags.sidecar;
+  if (Object.keys(output).length > 0) input.output = output;
+  return input;
+}
+function printArtifacts(artifacts) {
+  for (const a of artifacts) {
+    console.log(`${a.path ?? a.url}${a.sidecarPath ? `  (+ ${a.sidecarPath})` : ""}`);
+  }
+}
+async function runGen(prompt, flags) {
+  const result = await generate(buildGenerateInput(prompt, flags));
+  printArtifacts(result.artifacts);
+  if (result.seed !== void 0) console.log(`seed: ${result.seed}`);
+}
+
+// src/commands/repro.ts
+import { readFile } from "fs/promises";
+import { generate as generate2, ImageRequest } from "@merpuya/falgen";
+async function runRepro(sidecarPath, deps = {}) {
+  const gen = deps.generate ?? generate2;
+  const raw = JSON.parse(await readFile(sidecarPath, "utf8"));
+  const resolved = ImageRequest.parse(raw.resolved);
+  return gen(resolved);
+}
+
+// src/commands/spec.ts
+import { mkdir, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { stringify as toYaml } from "yaml";
+import { FileSpecSource, defaultSpecSearchPath, listSpecs } from "@merpuya/falgen";
+async function runSpecList() {
+  const specs = await listSpecs();
+  console.log(specs.length ? specs.join("\n") : "(no specs found)");
+}
+async function runSpecShow(name) {
+  const src = new FileSpecSource(defaultSpecSearchPath());
+  console.log(toYaml(await src.load(name)));
+}
+async function runSpecAdd(name, opts) {
+  const dir = opts.local ? join(process.cwd(), "falgen", "specs") : join(homedir(), ".config", "falgen", "specs");
+  await mkdir(dir, { recursive: true });
+  const path = join(dir, `${name}.yaml`);
+  const template = toYaml({
+    model: "fal-ai/flux/dev",
+    width: 1024,
+    height: 1024,
+    steps: 28,
+    guidance: 3.5
+  });
+  await writeFile(path, template, { flag: "wx" });
+  console.log(`created ${path}`);
+}
+
+// src/falgen.ts
+var toInt = (v) => Number.parseInt(v, 10);
+var toNum = (v) => Number.parseFloat(v);
+function buildProgram() {
+  const program = new Command();
+  program.name("falgen").description("Generate images via fal.ai to reusable specs");
+  program.command("gen").argument("<prompt>", "image prompt").option("-s, --spec <name>", "preset name").option("-m, --model <id>", "fal model id").option("--width <px>", "width", toInt).option("--height <px>", "height", toInt).option("--steps <n>", "inference steps", toInt).option("--guidance <n>", "guidance scale", toNum).option("--seed <n>", "seed", toInt).option("-n, --num-images <n>", "number of images", toInt).option("-o, --out <dir>", "output dir").option("--no-sidecar", "skip the json sidecar").action(async (prompt, o) => {
+    const flags = {
+      spec: o.spec,
+      model: o.model,
+      width: o.width,
+      height: o.height,
+      steps: o.steps,
+      guidance: o.guidance,
+      seed: o.seed,
+      numImages: o.numImages,
+      out: o.out,
+      sidecar: o.sidecar
+    };
+    await runGen(prompt, flags);
+  });
+  const spec = program.command("spec").description("manage preset specs");
+  spec.command("list").action(runSpecList);
+  spec.command("show").argument("<name>").action(runSpecShow);
+  spec.command("add").argument("<name>").option("--local", "write to ./falgen/specs").action(
+    (name, o) => runSpecAdd(name, o)
+  );
+  const auth = program.command("auth").description("manage the FAL_KEY");
+  auth.command("set").argument("<key>").action(runAuthSet);
+  program.command("repro").argument("<sidecar>", "path to a sidecar .json").action(
+    async (p) => {
+      const res = await runRepro(p);
+      printArtifacts(res.artifacts);
+    }
+  );
+  return program;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  buildProgram().parseAsync().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+  });
+}
+export {
+  buildProgram
+};

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@merpuya/falgen-cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "falgen": "./dist/falgen.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "yaml": "^2.5.0",
+    "@merpuya/falgen": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}