Package Exports

@genfeedai/cli
@genfeedai/cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@genfeedai/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

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