Draft first. Review always. Post never by accident.

Forge content with control.

Structured tasks, drafts, reviews, and scheduling — all local-first.

Get socialforge-ai View on GitHub

Local-firstSQLite backend

Draft-firstapproval workflow

Ollamalocal model fallback

MITlicense

Built for social content teams

Plan, draft, review, and schedule without losing control of the process.

Structured task setup

Objective, output type, platform, constraints, model lane, and execution plan keep AI work repeatable.

Draft-first workflow

Generate variants, review, edit, approve, and schedule — no live posting without explicit approval.

Visual work board

Move tasks through idea, drafting, review, approval, and scheduling with drag-and-drop cards.

Local model support

Optional Ollama integration with local fallback so the app works even when no model server is running.

Install in seconds

Run the backend and frontend in separate terminals, or use the provided Docker Compose stack.

git clone https://github.com/LumenHelixLab/socialforge-ai.git
cd socialforge-ai
# Terminal 1: backend
cd backend && python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/uvicorn main:app --reload --port 8787
# Terminal 2: frontend
cd frontend && npm install && npm run dev

Tested on Windows 11, macOS Sonoma, Ubuntu 22.04/24.04, and modern mobile browsers.

How it works

A FastAPI + SQLite backend serves a React + Vite job board and inspector.

Creator  ->  React/Vite Frontend  ->  FastAPI Backend  ->  SQLite + Local Model Adapter
             |                                                              |
             └────────── Drag-and-drop job board + calendar + inspector ────┘

Documentation

Everything you need to run, extend, and deploy socialforge-ai.