nodetool

NodeTool

Open-source agent-first creative workspace

Create images, video, audio, and text with agents that work alongside you. Describe what you want, let the agent build it, then take over whenever you like.

Create with AI. Make it your own. NodeTool combines an AI video editor with node-based workflows. Ask the agent to create a video, refine it in the timeline, or connect nodes to build a process you can reuse.

Download NodeTool Studio · Quick start · Documentation · MCP setup · Contribute

Every model you need, on your own keys

Run local models or connect cloud providers with your own API keys. NodeTool calls the provider with your key, at their price, with no billing unit in between. When a better model ships, add it the day it ships.

Models and Providers lists what runs where.

Run it on the AI plan you already pay for

Sign in with ChatGPT or Claude in Studio and the agent runs on that $20 subscription instead of a metered API bill. ChatGPT and Gemini plans also generate images, and Gemini generates video. Those runs count against your plan's own limits.

Plan	Chat and agent	Images	Video
ChatGPT	Yes	Yes	No
Claude	Yes	No	No
Gemini	Yes	Yes	Yes

Subscriptions run in Studio, the desktop app, not in Cloud. Gemini also needs the NodeTool Chrome extension in the browser where you are signed in.

Why NodeTool

• Agents drive the real editors. They wire the graph and run it. You take the wheel at any point.
• Inspect intermediate results, swap a model, and rerun only what changed.
• The graph, inputs, assets, and edits stay together in your project.
• Run the same workflow from the studio, the CLI, or an external agent over MCP.

Studio is free and runs on macOS, Windows, and Linux. Local models have hardware requirements that depend on the model, and offline work needs the models and assets on your machine. NodeTool Cloud is in alpha and runs on hosted storage and cloud providers.

First run in Studio

1. Download the latest release for your operating system and install it. See the installation guide for requirements and per-OS steps.
2. Connect providers through Settings → Models & Providers to enable agents and media generation.
3. Start a new project and follow along.

One workspace, brief through final cut

Write a brief and ask the agent for a storyboard. Approve the stills before spending on video, then assemble the clips on a timeline. Trim the cut, add narration, and export an MP4. Revise one shot without regenerating the film. The film quick start walks through each step.

Seven editors share one project, so a piece never leaves the studio to be finished. Each editor exposes its actions to the agent as tools, so the agent works in all of them.

Storyboard

Board the film shot by shot. Pitch a concept, a style, and a shot count, and you get back a screenplay: one shot per card with action, camera, motion, and duration, plus the logline, style bible, narration, and music direction.

• Cheap stages first. A Seedream 5 Lite still costs $0.03 on Kie.ai. Five seconds of Seedance 2 costs $1.03 (list prices via genspend.io, August 2026). Generate stills until one looks right, then animate that one.
• Revise one shot, not the reel. "Make it darker, add rain" runs video-to-video on that clip alone and returns a new take. You decide whether it replaces the old one.
• Entities keep the cast steady. Characters, locations, styles, and props paste the same descriptor into every prompt that names them.
• Assemble the cut. One click lays the shots onto a timeline with narration and music, each clip still linked to its shot.

The agent works the same board, with or without the editor open. Creative agent guide →

Script and voice

Draft the dialogue, cast a provider, model, and voice per character, and audition alternate readings. Each voicing saves its own take with word timings, and changing the words flags that take stale. The current takes assemble into a sequence, the timings riding along as captions. Ask the agent and it voices every line that still needs it, then cuts the sequence for you.

Timeline

Arrange, trim, and layer video and audio across tracks, down to the frame and the stem. Drop in your own footage, or bind a workflow to a clip and generate in place: change a parameter and the clip regenerates, tweak the workflow and the clip flags itself stale. Export to MP4. The agent edits the same document when you ask it to tighten the opening. Video editor guide →

Sketch

Build a composition in layers with blend modes and masks, then bind a layer to a model or a workflow and generate where you are painting. Change a prompt or an upstream input and the layer flags itself stale. The rest of the workflow receives the flattened image, the mask, and each layer on its own. Sketch editor guide →

3D

Place primitives and lights in a scene by hand or by asking, then capture a view as a depth or composition reference for an image or video model. The same scene builds and renders with no editor open, so it comes back the same way every time. 3D editor guide →

Game

Build a 2D or 3D game in a workspace tab and play it without leaving the editor. Place entities, give them behaviors or JavaScript, and bind generated sprites, sounds, and models to their slots. Ask the agent for a new enemy or a darker level and it edits the same draft. Publish a revision, then export it as a standalone web player that runs without NodeTool. Game editor guide →

The node editor

Underneath the editors is the node graph. Drag nodes in, connect typed ports, and read the live output at each step. Double-click the canvas to search for a node, or drag a connection into empty space to see what fits. The editor refuses a mismatch, so an image cannot land in a text field.

The editors connect to it. A timeline clip or a sketch layer can bind to a workflow, and the storyboard sends its stills and clips to one.

Example timelines

Each film below is a timeline document that ships with NodeTool, rendered to MP4. Select a poster to watch the film. Open the example in the app to edit every clip, track, and effect.

The showcase and template gallery hold the single workflows these films chain.

How NodeTool compares

Most AI video apps run only on their own servers. They choose which models you get, sell you credits for each try, and hand back an exported video while the project stays in their app. NodeTool leaves those choices, and the project, with you. The table compares the category, not a product.

	NodeTool	Hosted AI video apps
Models	Every major provider, switched in one click	The list they picked
When a better model ships	Add it the day it ships	Wait for them to add it
What you pay	The provider's own price, through your own account	Credits you buy from them, at prices they set
What you keep	The storyboard, every generated clip, and the edited video, as a project you can reopen	An exported video. The project stays in their app.
Source	Open source, AGPL-3.0	Closed
Where it runs	Desktop app, browser (Cloud alpha), or your own server	Their servers only

Choosing against a node tool instead? See ComfyUI and Figma Weave.

The agent

Most tools bolt a chat panel onto an editor. NodeTool built the editors around the agent: each surface exposes its actions to the agent as tools, so it can wire a graph, paint a layer, cut a clip, revise a shot, or voice a line.

• Build workflows. Describe the pipeline. The agent picks the nodes, wires the edges, and validates the graph, and leaves behind a workflow you own.
• Build apps. Ask for a custom UI. The agent plans the workflow, places widgets, and replays interactions. A judge model grades the result. No passing verdict, no app.
• Repair on the fly. Put an agent on the failure path and it decides whether to retry, repair, skip, or stop, within the cost budget you set.
• Bring your own agent. The toolbelt is exposed over MCP, so Claude Desktop, Claude Code, or Codex can drive the studio.

Underneath, a planner turns an objective into a DAG of steps, executors walk it in parallel, and every LLM call emits an OpenTelemetry span with tokens and cost. See the agent guide and docs/AGENTS.md.

What is underneath

Everything the film surfaces do is reachable on the canvas without the film.

Mini apps	Give a workflow a screen: inputs, a Run button, the result. Hand it to a teammate who never sees the canvas.
Editing tools as nodes	Mask, inpaint, outpaint, relight, upscale, layer, and composite.
Every modality	Image, video, audio, and text in one workflow.
Every major provider	OpenAI, Anthropic, Gemini, FAL, KIE, Replicate, ElevenLabs, HuggingFace, plus generated nodes for the fal.ai, Replicate, and KIE model catalogs and a fal.ai node that calls any endpoint by id.
Open weights	Ollama, MLX (Apple Silicon), and GGUF on your own hardware.
Document search	Index and query your files with the built-in vector store.
JS scripts	Versioned JavaScript documents with declared ports, saved test cases, and a QuickJS sandbox.
MCP server	Point Claude Desktop, Claude Code, Codex, or any MCP agent at the toolbelt.
Custom nodes	Extend in TypeScript or Python.
Deploy and scale	Self-host with Docker, with backup and rollback steps. Rent GPU workers on RunPod or Vast.

Documentation

• Getting Started — Build your first workflow
• Agents — Let an agent build, run, and repair your workflows
• Mini Apps — Wrap a workflow in an interface
• App Builder — Place widgets, wire them to a workflow, publish
• Creative Agent — Storyboard a film, gate the spend, assemble the cut
• JavaScript Sandbox — What JS scripts and Code nodes can reach
• Video Editor — Sequence and generate clips on a timeline
• Sketch Editor — Draw, mask, and generate on a layered canvas
• 3D Editor — Place objects, lights, and cameras in a glTF scene
• Game Editor — Build, play, and export 2D and 3D games
• Node Packs — Available nodes and integrations
• Custom Nodes — Extend NodeTool
• Provider Guides — Add new models and nodes for any provider
• Deployment — Share your work
• API Reference — Programmatic access

MCP

Give Claude Code a creative harness. A harness is everything an agent works inside: tools, editors, models, keys, and a record of each step. NodeTool supplies all five to the coding agent you already use. It can build and run a workflow, read the log of the step that failed, and save the fix as a new version, or work the storyboard, timeline, and other editors directly. See nodetool.ai/agents.

Use NodeTool from Claude Code, Codex, or OpenCode. One command registers the server with every client it finds. The desktop app is optional:

npx -y --package=@nodetool-ai/cli-mcp nodetool-mcp install

The command starts the server once to check it, then writes each client's config. Restart the client and ask it to use NodeTool. For other clients, nodetool-mcp config prints an mcpServers block. See NodeTool as an MCP Server.

For Claude Desktop, build the source MCP bundle after installing dependencies and building packages:

npm run build:mcpb
# writes dist/nodetool.mcpb

The MCP server can drive workflows and creative editing surfaces. See the MCP production guide and agent architecture.

First run from source

This deterministic example uses the repository's hello_input_output_cli.json template. It calls no model, so it needs no API key:

git clone https://github.com/nodetool-ai/nodetool.git
cd nodetool
nvm use                         # Requires nvm, reads the version from .nvmrc
npm install
npm run build:packages
npm run workflow -- ./examples/workflows/hello_input_output_cli.json \
  --input text='hello from NodeTool'

The input node named text connects to a Reroute output node. The command's JSON summary includes hello from NodeTool in its outputs. See examples/workflows/README.md for more CLI smoke tests and expected behavior. The creator workflow templates, mini apps, storyboards, timelines, and recipes shipped in Studio live in packages/base-nodes/nodetool/examples/ and are browsable in the template gallery.

To run an agent or a model-backed workflow, configure a provider first. Export an OpenAI key and use the checked-in OpenAI example:

export OPENAI_API_KEY='your-key'
npm run workflow -- ./examples/workflows/agent_openai_basic_cli.json \
  --input prompt='Write one sentence about workflow testing.'

This makes a paid provider request against GPT-4o. Access and billing depend on your provider account. See Models and Providers and Provider Guides for other providers and local setup. Do not add a key to a committed file.

CLI

Install the CLI with npm install -g @nodetool-ai/cli, using Node.js 22 or later. The CLI package guide covers running workflows with the installed command.

To serve the API, run nodetool serve in a separate terminal. Commands that support remote execution accept --api-url or NODETOOL_API_URL. For interactive agent chat, connect a provider first as described in the CLI package guide, then run nodetool-chat.

See the CLI reference and CLI package guide. A one-off install is available with npx --package=@nodetool-ai/cli nodetool --help.

Development setup

After the source quick start, start the API and web UI from the prepared checkout:

npm run dev

For an automatic install, build, and launch from a fresh checkout, use ./start.sh full. To start only the API, use ./start.sh. To inspect the environment without changing it, use ./start.sh doctor. None of these launch the Electron desktop app.

In a separate terminal, launch the desktop shell with npm run electron. The Node.js version is pinned in .nvmrc. Python 3.11 or newer is optional, for Python nodes. See Python nodes without the desktop app. For locked-down environments or missing WebGPU, see development environment.

Testing

After a code change, run these four repository-root checks from the commands in AGENTS.md:

npm run test:affected
npm run typecheck
npm run lint
npm run dev:nodetool -- harness gate --base origin/main

The web testing guide is at web/TESTING.md. The complete repository gate is npm run check.

Project layout

Path	Purpose
packages/	TypeScript runtime, workflow kernel, agents, providers, and nodes
web/	React web UI
electron/	Desktop Studio shell
mobile/	React Native app
docs/	Documentation and development guides
packages/base-nodes/nodetool/examples/	Shipped workflow templates, mini apps, storyboards, timelines, and recipes
examples/workflows/	CLI smoke-test workflow examples

Contributing

Read AGENTS.md and the development standards, then open an issue for larger changes. Pull requests for bug fixes, nodes, providers, workflows, and documentation are welcome. Run the narrowest relevant checks before opening a PR and include their results.

License and community

NodeTool is licensed under AGPL-3.0.

GitHub · Discord · Website