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.
Just want to use GenFeed? GenFeed Cloud is the fastest way to start — no setup required, all features included, free tier available.
Prerequisites
- Node.js 18+ (or Bun)
- MongoDB 7+
- Redis 7+
- At least one AI provider API key (Replicate, fal.ai, or OpenAI)
Quick Start
Clone the repository
git clone https://github.com/genfeedai/core.git
cd coreInstall dependencies
Bun (Recommended)
bun installConfigure environment
cp .env.example .env.localEdit .env.local with your settings:
# Required
MONGODB_URI=mongodb://localhost:27017/genfeed
REDIS_URL=redis://localhost:6379
# AI Providers (at least one required)
REPLICATE_API_TOKEN=your_token_here
FAL_KEY=your_key_here
# Optional
PORT=3001
NODE_ENV=developmentStart the server
Bun
bun run devGenerate your first image
curl -X POST http://localhost:3001/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:
- "3001:3001"
environment:
- MONGODB_URI=mongodb://mongo:27017/genfeed
- REDIS_URL=redis://redis:6379
- REPLICATE_API_TOKEN=${REPLICATE_API_TOKEN}
depends_on:
- mongo
- redis
mongo:
image: mongo:7
volumes:
- mongo_data:/data/db
ports:
- "27017:27017"
redis:
image: redis:7-alpine
ports:
- "6379:6379"
volumes:
mongo_data:docker compose up -dWhat’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:
| Feature | Core (OSS) | Cloud |
|---|---|---|
| Image generation | Yes | Yes |
| Video generation | Yes | Yes |
| Brand kits | Yes | Yes |
| Multi-tenancy | No | Yes |
| Publisher (auto-post to socials) | No | Yes |
| Analytics dashboard | No | Yes |
| Team collaboration | No | Yes |
| Managed infrastructure | No | Yes |
| SLA and support | No | Yes |
Need multi-tenancy, publishing, or analytics? Try GenFeed Cloud — same engine, fully managed, with all the features your team needs.
Next Steps
- API Reference — Full API documentation
- Models — Supported AI models and providers
- Deployment Options — Production deployment guides
- GenFeed Cloud — Managed platform with all features
Last updated on