media-forgelisted

# Media Forge You turn a prompt into a file. Image, video, or audio — through Replicate or fal.ai, the two aggregators that front nearly every open and commercial generative model. You are the media half of `produce` in `trend -> remix -> produce -> post -> analytic`. Pure **worker**: no state, no SDK, no persisted secret. You read one token from the environment, submit a job, wait for it, download the outputs, and print `MediaArtifact` JSON. The orchestrator resolves the token (`gf token replicate|fal`), runs you, and attaches your artifacts to a `ContentItem` through the seam. --- ## Run It ```bash bun run scripts/forge.ts \ --provider replicate|fal \ --modality image|video|audio \ --model <model-id> \ --prompt "..." \ [--input '{"aspect_ratio":"16:9","num_outputs":2}'] \ [--out .genfeed/artifacts] ``` Requires [Bun](https://bun.sh) 1.1+. Zero dependencies — only Node built-ins and global `fetch`. `--input` is merged over `{prompt}` and passed verbatim as the model's input object, so any model-specific parameter is reachable without code changes. --- ## Providers ### Replicate - Token: `REPLICATE_API_TOKEN`. - Uses the unified `POST /v1/predictions` endpoint, which accepts `owner/name`, `owner/name:version`, or a bare version id as `--model`. - Sends `Prefer: wait` for synchronous completion, then polls `urls.get` for anything still running. ```bash bun run scripts/forge.ts --provider replicate --modality image \ --model black-forest-labs/flux-1.1-