shrimbly/node-banana

What is Node Banana?

Node Banana is a desktop‑first visual workflow editor for building AI‑generated media pipelines. You drag‑and‑drop typed nodes onto an infinite canvas, connect them, and run the graph. The app then calls the selected AI providers (image, video, audio, 3D, or text models) in dependency order and saves the results locally.

Who might use it?

Creators who want to chain several AI services (e.g., generate an image, feed it to a caption model, then turn the caption into audio) without writing code.
Teams that need a reproducible, shareable JSON description of a media pipeline.
Anyone who prefers a private, offline‑first workflow (keys are encrypted, files stay on disk) but still wants to tap cloud AI APIs.

Core features (as described in the README)

Feature	What it does
Desktop app	Signed macOS (Apple Silicon) client that auto‑updates; Windows version is planned.
Agent	Built‑in chat that can create or edit workflows using your own Claude‑Code or Codex subscription; runs locally, never consumes API credits.
Asset library	All generated media is saved on disk and browsable with tags, favourites, and a link back to the workflow that produced it.
Dynamic prompting	Variables, LLM‑powered prompt construction, and reusable prompt chains that adapt per run.
Prompt‑to‑workflow	Turn a natural‑language description into a full workflow automatically.
Multi‑provider support	Google Gemini, Replicate, fal.ai, Kie.ai, WaveSpeed, ComfyUI (via router), and OpenAI (LLM only).
Media generation nodes	Images, video, audio, 3D models, and text generation.
Image annotation	Full‑screen drawing editor (shapes, freehand, text).
Workflow controls	Group locking, batch runs, conditional switches, routers, and easy save/load as portable JSON.
Extensive node library	Over 20 built‑in node types covering inputs, generators, transformers, and outputs.

How to get started

Download the macOS app from nodebanana.app (Apple Silicon) or run the source code.
Add API keys for the providers you plan to use (Settings → Providers). Keys are stored encrypted on your machine.
Create a workflow by dragging nodes, connecting handles, and configuring prompts.
Run the graph – the app calls the selected APIs in order and writes the outputs to the local Assets folder.

Running from source (quick summary)

git clone https://github.com/shrimbly/node-banana.git
cd node-banana
npm install
npm run dev   # starts the web UI at http://localhost:3000

For the native desktop version use npm run electron:dev (requires Node 22+).

What the repo contains

Next.js + TypeScript front‑end powered by React Flow for the canvas.
Electron wrapper for the desktop client.
Tests, linting, and type‑checking scripts.
Example workflow JSON files in /examples.
Documentation site hosted at node-banana-docs.vercel.app.

License & community

The project is MIT‑licensed. Support and discussion happen on Discord and via the GitHub issue tracker.

All details above are taken directly from the repository’s README; no additional features are inferred.