Self-Host GenFeed in 5 Minutes

Get GenFeed Core running on your own infrastructure. Generate AI content with full control over models, data, and costs.

Prerequisites

• Node.js 18+ (or Bun)
• PostgreSQL 17+
• Redis 7+
• At least one AI provider API key (Replicate, fal.ai, or OpenAI)

Quick Start

git clone https://github.com/genfeedai/genfeed.ai.git
cd genfeed.ai

bun install

npm install

cp .env.example .env.local
bun run env:sync local

# Required
DATABASE_URL=postgresql://genfeed:genfeed_local@localhost:5432/genfeed
REDIS_URL=redis://localhost:6379
 
# AI Providers (at least one required)
REPLICATE_KEY=your_token_here
FAL_API_KEY=your_key_here
 
# Optional
PORT=3010
NODE_ENV=development

bun run dev

npm run dev

curl -X POST http://localhost:3010/api/generate/image \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A modern tech startup office, minimalist design",
    "model": "flux-schnell",
    "width": 1024,
    "height": 1024
  }'

Docker Compose

For a production-ready setup with all dependencies:

# docker-compose.yml
version: '3.8'
 
services:
  genfeed:
    build: .
    ports:
      - '3010:3010'
    environment:
      - DATABASE_URL=postgresql://genfeed:genfeed_local@postgres:5432/genfeed
      - REDIS_URL=redis://redis:6379
      - REPLICATE_KEY=${REPLICATE_KEY}
    depends_on:
      - postgres
      - redis
 
  postgres:
    image: postgres:17-alpine
    environment:
      - POSTGRES_DB=genfeed
      - POSTGRES_USER=genfeed
      - POSTGRES_PASSWORD=genfeed_local
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - '5432:5432'
 
  redis:
    image: redis:7-alpine
    ports:
      - '6379:6379'
 
volumes:
  postgres_data:

docker compose up -d

What’s Included

• Image generation (Flux, SDXL, and more via Replicate/fal.ai)
• Video generation (short-form, with captions)
• Brand kit management
• Job queue (BullMQ + Redis)
• REST API
• Webhook support

What’s NOT Included (Cloud Only)

Some features require the full GenFeed Cloud platform:

Next Steps

• API Reference — Full API documentation
• Models — Supported AI models and providers
• Execution Boundaries — Local, BYOK, managed, and Cloud runtime contract
• Deployment Options — Production deployment guides
• GenFeed Cloud  — Managed platform with all features