Run your first NodeTool workflow in under 10 minutes. No AI experience or coding needed.
By the end of this guide, you’ll have:
- Installed NodeTool and set up AI models
- Run a complete workflow end-to-end
- Customized inputs and seen different results
- Shared your workflow as a Mini-App
Want a visual overview first? See the Start Here section on the home page for a quick orientation.
Step 1 — Install NodeTool
Check Requirements
Before installing, make sure your machine meets the minimum requirements:
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 8 GB | 16 GB+ |
| Disk | 10 GB free | 50 GB+ (for models) |
| GPU | None (CPU works) | 8 GB+ VRAM for local AI |
| OS | macOS 13+, Windows 10+, Ubuntu 22+ | Latest version |
No GPU? No problem. You can use cloud AI providers (OpenAI, Anthropic, Replicate) instead of local models. See Hardware Requirements for details.
Install
- Download from nodetool.ai for macOS, Windows, or Linux
- Run the installer — follow the platform-specific prompts
- Launch NodeTool — the app opens immediately, no setup wizard needed

Python and AI engines are installed on demand when you first use local models. See Installation Guide for platform-specific instructions and troubleshooting.
Install AI Models (Optional)
For running AI locally without cloud APIs:
- Open Models from the sidebar
- Install starter models:
- Flux or Qwen Image — image generation (needs 8–12 GB VRAM)
- A text model like Llama or Qwen — chat and text generation
- Wait for downloads (~20 GB total)
Using cloud instead? Go to Settings → Providers, paste an API key from OpenAI, Anthropic, or Google, and skip local model downloads.
How to verify: You should see the Dashboard with template workflows listed. If models are installed, they appear with a green checkmark in the Models panel.
Step 2 — Run Your First Workflow
Now that NodeTool is installed, let’s run a real workflow. Pick one of the templates below to try:

Option A: Generate Movie Posters
- Find it: Dashboard → Templates → “Movie Posters”
- Open in Editor: See the workflow canvas
- How it works:
- Input nodes (left) - Describe your movie
- AI Strategy node (middle) - Plans the visual
- Image Generator (right) - Creates the poster
- Preview - Shows your result
- Try it: Click the input nodes and type:
- Title: “Ocean Depths”
- Genre: “Sci-Fi Thriller”
- Audience: “Adults who love mystery”
- Run: Click Run (bottom-right) or press Ctrl/⌘ + Enter
- Watch: Poster generates step by step
Option B: Creative Story Ideas

- Find it: Dashboard → Templates → “Creative Story Ideas”
- How it works:
- Input nodes - Your parameters
- AI Agent - Generates ideas
- Preview - Shows results
- Try it: Click the input nodes and type:
- Genre: “Cyberpunk”
- Character: “Rogue AI detective”
- Setting: “Neon-lit underwater city”
- Run: Click Run or Ctrl/⌘ + Enter
- Watch: Ideas appear one at a time
✅ Done - You ran your first workflow.
Step 3 — Customize and Iterate
Now that you’ve seen a workflow run, try making it your own:
- Save your workflow: Press Ctrl/⌘ + S and give it a descriptive name
- Change inputs and re-run: Edit the text inputs and press Run again to see different results
- Explore the graph:
- Click any node to see its settings in the right panel
- Hover over connections to see what data is flowing between nodes
- Add Preview nodes (press
Space, search “Preview”) to inspect intermediate results
Workflows are reusable — try different variations, refine your inputs, and save your favorites.
✅ Done - You can customize workflows.
Step 4 — Share as a Mini-App
Turn any workflow into a simple app that anyone can use — no NodeTool knowledge required:
- Open your workflow in the editor
- Click Mini-App (top-right corner of the toolbar)
- See the simplified view: Only inputs and outputs are visible, the node graph is hidden
Mini-Apps are perfect for sharing with teammates, clients, or anyone who just wants to use the workflow without understanding how it’s built.
Want a custom UI? Use VibeCoding to design a fully custom interface for your Mini-App with AI assistance.
✅ Done - You know two ways to work: the Visual Editor (full control) and Mini-Apps (simple interface).
What You Learned
| Step | What You Did |
|---|---|
| Install | Downloaded NodeTool, set up models or cloud providers |
| Run | Executed a template workflow end-to-end |
| Customize | Changed inputs and saw different results |
| Share | Converted a workflow into a Mini-App |
Next Steps
Pick what interests you most:
| Goal | Where to Go |
|---|---|
| Understand how workflows work | Key Concepts |
| Learn the full interface | User Interface, Workflow Editor |
| Try more workflows | Workflow Gallery, Workflow Patterns |
| Set up more AI models | Models & Providers |
| Build workflows from scratch | Workflow Editor, Tips & Tricks |
| Deploy to production | Deployment Guide |
| Fix a problem | Troubleshooting, Workflow Debugging |
Community: Discord · GitHub Issues · Glossary