A visual workflow builder for AI and media pipelines. Create workflows with drag-and-drop nodes (text, images, video, LLM, crop, extract frame), connect them, and run—either in the browser or via background jobs.
- Canvas workflows — Add nodes (Text, Upload Image/Video, LLM, Crop Image, Extract Frame), connect inputs/outputs, validate DAG.
- Run & results — Run the full workflow or selected nodes; see outputs in the History sidebar and on each node.
- Auth & persistence — Sign in with Clerk; workflows and runs stored in PostgreSQL.
- Optional background runs — Use Trigger.dev for runs in a worker, or run in-process when not configured.
- Node.js 20+
- PostgreSQL (local or hosted, e.g. Neon)
- Clerk account (auth)
- Google AI API key (Gemini, for LLM node)
- Multer handles image uploads (built-in, no external service needed)
git clone <repo-url>
cd virtual-workflow-builder
npm installCopy the example env and fill in values:
cp .env.example .env| Variable | Required | Description |
|---|---|---|
DATABASE_URL |
Yes | PostgreSQL connection string |
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY |
Yes | From Clerk |
CLERK_SECRET_KEY |
Yes | From Clerk |
GEMINI_API_KEY |
Yes | For LLM node (Google AI) |
| TRIGGER_SECRET_KEY / TRIGGER_PROJECT_REF | Optional | For background runs (Trigger.dev) |
Without Trigger, runs execute in-process in the Next.js server. With Trigger, start the worker (see below).
npm run prisma:migratenpm run devOpen http://localhost:3000, sign in, create or open a workflow, add nodes, connect them, and click Run.
To run workflows in a Trigger.dev worker:
- Create a project at cloud.trigger.dev and add
TRIGGER_SECRET_KEYandTRIGGER_PROJECT_REFto.env. - In a second terminal:
npm run dev:triggerKeep this running while using Run so the worker can process jobs. If the worker isn’t running, the app falls back to in-process execution.
| Command | Description |
|---|---|
npm run dev |
Start Next.js dev server |
npm run dev:trigger |
Start Trigger.dev worker (optional) |
npm run build |
Production build |
npm run start |
Start production server |
npm run prisma:migrate |
Apply DB migrations |
npm run typecheck |
TypeScript check |
Next.js 16 · React 19 · Prisma · PostgreSQL · Clerk · React Flow · Trigger.dev · Google Gemini · Multer