### Install Genmedia CLI on Linux/macOS Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Installs the genmedia CLI using curl. This is the standard installation method for Linux and macOS systems. ```bash curl https://genmedia.sh/install -fsS | bash ``` -------------------------------- ### Setup Genmedia CLI Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Initiates the interactive setup wizard for the genmedia CLI. This wizard configures API key, .env loading, output mode, and automatic updates. ```bash genmedia setup ``` -------------------------------- ### Install Genmedia CLI on Windows Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Installs the genmedia CLI using PowerShell's Invoke-Expression. This is the standard installation method for Windows systems. ```powershell irm https://genmedia.sh/install.ps1 | iex ``` -------------------------------- ### Non-interactive Genmedia CLI Setup Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Performs a non-interactive setup for the genmedia CLI, suitable for agents or CI environments. Allows specifying API key, output format, and update behavior. ```bash genmedia setup --non-interactive --api-key "$FAL_KEY" ``` ```bash genmedia setup --non-interactive --output-format json --no-auto-load-env --auto-update ``` -------------------------------- ### Initialize Default Genmedia Skill Bundle Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Installs the default genmedia skill bundle. Use the --force flag to overwrite existing files. ```bash genmedia init ``` ```bash genmedia init --force # overwrite existing files ``` -------------------------------- ### Search Documentation Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Search fal.ai documentation, guides, and API references using the `docs` command with a query string. ```bash genmedia docs "how to use LoRA" ``` ```bash genmedia docs "webhook callbacks" ``` -------------------------------- ### Manage Installed Agent Skills Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Commands to list, install, update, and remove agent skills. Use 'list ' for full-text search. ```bash genmedia skills list # list everything in the registry ``` ```bash genmedia skills list image # full-text search name + description ``` ```bash genmedia skills install genmedia ``` ```bash genmedia skills update ``` ```bash genmedia skills remove genmedia ``` -------------------------------- ### Get Command Schema with JSON Output Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Retrieve a machine-readable description of all commands, arguments, and options in JSON format. ```bash genmedia --help --json ``` -------------------------------- ### Set FAL_KEY environment variable Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Sets the FAL_KEY environment variable to authenticate with fal.ai. This can be used to skip the interactive setup wizard. ```bash export FAL_KEY=your_fal_api_key ``` -------------------------------- ### Check for and Apply CLI Updates Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Use `genmedia update` to download and install the latest release of the Genmedia CLI. The `--check` option verifies if an update is available without downloading, and `--force` reinstalls the current version. ```bash genmedia update # download and swap in the latest release genmedia update --check # only check, don't download genmedia update --force # reinstall even if already on the latest ``` -------------------------------- ### Opt out of Analytics Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md You can opt out of analytics reporting either per-shell by exporting an environment variable or persistently by using the setup command. ```bash export GENMEDIA_NO_ANALYTICS=1 # per-shell ``` ```bash genmedia setup # (toggle is currently file-only — set "analyticsOptOut": true) ``` -------------------------------- ### Browse Generated Assets with `genmedia gallery` Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Use `genmedia gallery` to view a preview of generated assets. Options allow for JSON output, opening the gallery, listing sessions, renaming, and clearing sessions. ```bash genmedia gallery # pretty TTY: prints `→ Open: `. JSON / non-TTY: full info payload. genmedia gallery --json # structured info payload, agent-safe genmedia gallery info # full info payload, even from a TTY (devs) genmedia gallery open # open the all-sessions index in the default browser genmedia gallery open current # open the current session genmedia gallery open latest # open the most-recently recorded session (works across shells) genmedia gallery open # open a specific session genmedia gallery open latest --print # resolve path/url without launching the browser genmedia gallery list # list every recorded session (newest first, JSON-friendly) genmedia gallery list --limit 10 # cap the list (default: 50) genmedia gallery rename --label "demo run" # rename the current session (cosmetic — id stays the same) genmedia gallery rename latest --label "x" # rename the most-recent session genmedia gallery rename --clear # remove a session's label genmedia gallery clear --yes # delete the current session (--yes is required) genmedia gallery clear latest --yes # delete the most-recently recorded session genmedia gallery clear --yes # delete a specific session genmedia gallery clear all --yes # delete every recorded session ``` -------------------------------- ### Gallery Information in `run` and `status` Responses Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md The `run` and `status --download` commands include gallery information, such as session ID and the path to the generated HTML preview. ```json { "status": "completed", "endpoint_id": "fal-ai/flux/dev", "request_id": "…", "gallery": { "session_id": "a1b2c3d4e5f6", "path": "/Users/you/.genmedia/gallery/sessions/a1b2c3d4e5f6/index.html", "url": "file:///Users/you/.genmedia/gallery/sessions/a1b2c3d4e5f6/index.html" } } ``` -------------------------------- ### Show Version Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Display the current version of the genmedia CLI and check for available updates. ```bash genmedia version ``` -------------------------------- ### Check Model Pricing Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Use the `pricing` command to check the cost associated with a specific model. ```bash genmedia pricing fal-ai/flux/dev ``` -------------------------------- ### Run Genmedia Model Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Runs a specified model using the genmedia CLI. Supports passing parameters as flags, streaming logs, asynchronous execution, and downloading results. ```bash genmedia run fal-ai/flux/dev --prompt "a cat on the moon" ``` ```bash genmedia run fal-ai/flux/dev --prompt "a cat" --num_images 2 ``` ```bash genmedia run fal-ai/flux/dev --prompt "a cat" --logs ``` ```bash genmedia run fal-ai/veo3.1 --prompt "a dog running" --async ``` ```bash genmedia run fal-ai/flux/dev --prompt "a cat" --download # save to cwd with source file names ``` ```bash genmedia run fal-ai/flux/dev --prompt "a cat" --num_images 3 --download "./out/{index}.{ext}" ``` ```bash genmedia run fal-ai/flux/dev --help # introspect model inputs as CLI help ``` -------------------------------- ### Run Command with JSON Output Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Execute commands and receive structured JSON output, useful for piping to other tools like jq. ```bash genmedia run fal-ai/flux/dev --prompt "a cat" --json ``` ```bash genmedia models "text to video" --json | jq '.models[]' ``` -------------------------------- ### Upload Files to CDN Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Upload local files or remote URLs to the fal.ai CDN using the `upload` command. The command returns a CDN URL that can be used as model input. ```bash genmedia upload ./photo.jpg ``` ```bash genmedia upload https://example.com/image.png ``` -------------------------------- ### Inspect Genmedia Model Schema Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Inspects the input and output schema of a genmedia model. Supports compact and OpenAPI formats. ```bash genmedia schema fal-ai/flux/dev ``` ```bash genmedia schema fal-ai/flux/dev --format openapi ``` -------------------------------- ### Search Genmedia Models Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Searches for models in the genmedia CLI. Supports filtering by category, status, and specific endpoint IDs, with pagination. ```bash genmedia models "text to video" ``` ```bash genmedia models "flux" --category text-to-image ``` ```bash genmedia models --category text-to-speech --limit 5 ``` ```bash genmedia models --status all # include deprecated ``` ```bash genmedia models --endpoint_id fal-ai/flux/dev,fal-ai/flux/schnell # fetch specific models ``` ```bash genmedia models --endpoint_id fal-ai/flux/dev --expand openapi-3.0 ``` ```bash genmedia models "flux" --cursor # next page ``` -------------------------------- ### Check Async Job Status Source: https://github.com/fal-ai-community/genmedia-cli/blob/main/README.md Use the `status` command to check the progress of an asynchronous job. Options include fetching the result, viewing logs, canceling the job, or downloading the result to a specified directory. ```bash genmedia status fal-ai/veo3.1 ``` ```bash genmedia status fal-ai/veo3.1 --result ``` ```bash genmedia status fal-ai/veo3.1 --logs ``` ```bash genmedia status fal-ai/veo3.1 --cancel ``` ```bash genmedia status fal-ai/veo3.1 --download ./out/ # implies --result ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.