@genfeedai/cli

   ___            __             _    ___ _    ___
  / __|___ _ _   / _|___ ___ ___| |  / __| |  |_ _|
 | (_ / -_) ' \ |  _/ -_) -_) -_) | | (__| |__ | |
  \___\___|_||_||_| \___\___\___|_|  \___|____|___|

  > What image | video do you want to create? _

CLI tool for Genfeed.ai - Generate, schedule, analyze, and publish AI content from your terminal.

Requirements

• Node.js 18+
• A Genfeed.ai account with API access

Installation

Using bun (recommended):

bun add -g @genfeedai/cli

Using npm:

npm install -g @genfeedai/cli

Quick Start

Login with your API key:

genfeed login

Generate an image:

genfeed generate image "A futuristic cityscape at sunset"

Generate a video:

genfeed generate video "A drone flying over mountains"

Authentication

Get your API key from the Genfeed.ai dashboard.

Interactive login:

genfeed login

Non-interactive login:

genfeed login --key gf_live_xxx

Check current user:

genfeed whoami

Logout:

genfeed logout

Commands

Brand Management

List all brands:

genfeed brands

Select active brand:

genfeed brands select

Show current brand:

genfeed brands current

Image Generation

Basic generation:

genfeed generate image "Your prompt here"

With options:

genfeed generate image "Your prompt" --model imagen-4 --width 1920 --height 1080 --output ./image.jpg

Don't wait for completion:

genfeed generate image "Your prompt" --no-wait

Video Generation

Basic generation:

genfeed generate video "Your prompt here"

With options:

genfeed generate video "Your prompt" --model google-veo-3 --duration 10 --resolution 1080p --output ./video.mp4

Article Generation

Generate an article:

genfeed generate article "Write about AI marketing trends" --category marketing

Generate long-form X article:

genfeed generate article-x "Write a founder update thread"

Start async and poll later:

genfeed generate article "Your prompt" --no-wait
genfeed status <article-id> --type article

Check Status

Check image status:

genfeed status <id>

Check video status:

genfeed status <id> --type video

Check article status:

genfeed status <id> --type article

Batch Generation

genfeed batch create -n 5 -p twitter,linkedin --topics ai,product --style professional
genfeed batch list
genfeed batch show <batch-id>
genfeed batch approve <batch-id>

Templates

genfeed template list
genfeed template create --label "LinkedIn Hook" --purpose prompt --content "Write a hook about {{topic}}"
genfeed template use <template-id> --variables '{"topic":"AI workflows"}'

Scheduling and Insights

genfeed schedule calendar
genfeed insights
genfeed insights times --platform twitter
genfeed performance weekly
genfeed credits summary
genfeed posts list --platform twitter --status published

Darkroom (Admin)

Check GPU health:

gf darkroom health

Manage ComfyUI service:

gf darkroom comfy status
gf darkroom comfy restart

List available LoRA models:

gf darkroom loras

Training (Admin)

Start LoRA training:

gf train <handle> --steps 2000 --wait

Check training status:

gf train status <jobId> --watch

Datasets (Admin)

View dataset info:

gf dataset info <handle>

Upload training images:

gf dataset upload <handle> ./images/

Download dataset:

gf dataset download <handle> ./output/

Captioning (Admin)

Run Florence-2 auto-captioning on a dataset:

gf caption <handle>
gf caption <handle> --trigger "custom_trigger"

Options

Global Options

| Option | Description | |--------|-------------| | --json | Output as JSON (for scripting) | | --help | Show help | | --version | Show version |

Generation Options

| Option | Description | |--------|-------------| | -m, --model <model> | Model to use | | -b, --brand <id> | Override active brand | | -o, --output <path> | Download to file | | --no-wait | Don't wait for completion |

Image-specific Options

| Option | Description | |--------|-------------| | -w, --width <px> | Image width | | -h, --height <px> | Image height |

Video-specific Options

| Option | Description | |--------|-------------| | -d, --duration <sec> | Video duration | | -r, --resolution <res> | Resolution (720p, 1080p, 4k) |

Scripting

Use --json for machine-readable output:

Get image URL:

URL=$(genfeed generate image "prompt" --json | jq -r '.url')

Check status programmatically:

STATUS=$(genfeed status abc123 --json | jq -r '.status')

Agent Integration

The Genfeed CLI is designed for use by AI agents and automation tools.

Non-Interactive Authentication

genfeed login --key $GENFEED_API_KEY

JSON Output

All commands support --json for machine-readable output:

genfeed generate image "A sunset over mountains" --json
genfeed generate video "Product demo" --json
genfeed brands --json

Async Operations

Use --no-wait to get an ID immediately without waiting for completion:

# Start generation and get ID
ID=$(genfeed generate image "prompt" --no-wait --json | jq -r '.id')

# Poll for completion
genfeed status $ID --json

Agent Usage Example

# Authenticate
genfeed login --key gf_live_xxx

# Generate an image
RESULT=$(genfeed generate image "Professional headshot, studio lighting" --json)
IMAGE_ID=$(echo $RESULT | jq -r '.id')

# Check status
genfeed status $IMAGE_ID --json

# Publish to social media
genfeed publish $IMAGE_ID --platforms twitter,linkedin --json

MCP Server

For richer integration, connect directly to the Genfeed MCP server:

Endpoint: https://mcp.genfeed.ai/mcp
Transport: Streamable HTTP
Auth: Bearer token (API key)

See the MCP documentation for details.

Configuration

Config is stored in ~/.gf/config.json:

{
  "activeProfile": "default",
  "profiles": {
    "default": {
      "apiUrl": "https://api.genfeed.ai/v1",
      "role": "user",
      "darkroomHost": "100.106.229.81",
      "darkroomApiPort": 8189,
      "defaults": {
        "imageModel": "imagen-4",
        "videoModel": "google-veo-3"
      }
    }
  }
}

Environment Variable Overrides

| Variable | Description | |----------|-------------| | GENFEED_API_KEY | API key | | GENFEED_API_URL | API base URL | | GENFEED_TOKEN | Auth token | | GENFEED_ORGANIZATION_ID | Organization ID | | GENFEED_USER_ID | User ID | | GF_DARKROOM_HOST | Darkroom GPU host IP | | GF_DARKROOM_PORT | Darkroom API port |

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT