nodetool-base

A collection of reusable nodes for Nodetool. These nodes implement common functionality for text, audio, video, images and more. They build on the runtime provided by nodetool-core.

Overview

Nodetool lets you compose AI workflows as graphs. nodetool-base ships with a rich set of nodes so you can build useful flows out of the box. The nodes are organised into several namespaces under src/nodetool/nodes:

• calendly – access to Calendly events
• chroma – Chroma vector database operations
• google – Google image generation
• lib – helpers using libraries like BeautifulSoup, LlamaIndex or PyMuPDF
• nodetool – core utilities such as audio, boolean logic, image processing and more
• openai – wrappers around OpenAI APIs

Example workflows using these nodes can be found in src/nodetool/examples/nodetool-base.

Installation

git clone https://github.com/nodetool-ai/nodetool-base.git
cd nodetool-base
poetry install

This installs nodetool-core and other dependencies.

Documentation

Detailed documentation for each node group lives in the docs/ folder. Start with docs/index.md which lists all available node categories:

Available Nodes

• lib.audio - Save audio files to the assets directory.
• nodetool.boolean - Logical operators, comparisons and flow control helpers.
• nodetool.code - Evaluate expressions or run small Python snippets (development use).
• nodetool.constant - Provide constant values like numbers, strings and images.
• nodetool.control - Basic branching with an if node.
• nodetool.date - Utilities for manipulating dates and times.
• nodetool.dictionary - Manipulate key/value data and dictionaries.
• nodetool.group - Group operations such as looping over inputs.
• nodetool.image - Image manipulation including crop, resize and save.
• nodetool.input - Nodes for collecting user input of various types.
• nodetool.json - Parse, query and validate JSON data.
• nodetool.list - List processing utilities.
• nodetool.math - Basic arithmetic and math functions.
• nodetool.os - File system and path helpers.
• nodetool.output - Output nodes to return results to the user.
• nodetool.text - Text processing nodes with regex and templating.
• nodetool.video - Video editing and generation tools.

Refer to the individual markdown files for usage details and examples of each node.

Running tests

pytest -q

Most tests run without network access.

Contributing

Contributions are welcome. Feel free to open issues or pull requests on GitHub.