Griptape Nodes is a powerful, visual, node-based workflow builder designed for professional artists and creators. Build and execute complex AI workflows through the cloud-based Griptape Nodes IDE - an intuitive drag-and-drop interface.
This repository contains the Griptape Nodes Engine - the local component that runs securely on your machine, providing a performant foundation for workflow execution. The engine is published to PyPI as the griptape-nodes-engine library and is launched by the griptape-nodes application. To develop against the engine with a local checkout, see CONTRIBUTING.md.
✨ Key Features:
- 🎯 Visual Workflow Editor: Design and connect nodes representing different AI tasks, tools, and logic through the cloud-based IDE
- 🏠 Local Engine: Run workflows securely on your own machine or infrastructure
- 🐍 Portable Python Workflows: Workflows are saved as self-executable Python files for portability, debugability, and learning
- 🌐 Multi-Device Access: Client/server architecture lets you access your workflows from any device
- 🧩 Extensible: Build your own custom nodes and libraries to extend functionality
- ⚡ Scriptable Interface: Interact with and control flows programmatically
🔗 Learn More:
- 📚 Full Documentation: docs.griptapenodes.com
- ⚙️ Installation: docs.griptapenodes.com/en/stable/installation/
- 🔧 Engine Configuration: docs.griptapenodes.com/en/stable/configuration/
- 📋 Migration Guide: MIGRATION.md - Guide for migrating from deprecated nodes
- 📝 Changelog: CHANGELOG.md - Notable changes in each release
🧩 Extending Griptape Nodes:
Want to create custom nodes for your specific workflow needs? Griptape Nodes is designed to be extensible through custom libraries:
- 📦 Custom Library Template: Get started with the Griptape Nodes Library Template
- 🛠️ Build Custom Nodes: Create specialized nodes tailored to your artistic and creative workflows
🚀 Quick Installation
Option 1: Griptape Nodes Desktop (Recommended)
Download Griptape Nodes Desktop — a bundled app that includes both the engine and the editor. No additional setup required.
Option 2: Manual Engine Install
For users who prefer to install the engine directly:
-
🔐 Login: Visit Griptape Nodes and log in or sign up using your Griptape Cloud credentials.
-
💾 Install Engine: Install the engine using uv:
uv tool install griptape-nodes
-
⚙️ Initial Configuration (Automatic on First Run):
- The first time you run the engine command (
griptape-nodesorgtn), it will guide you through the initial setup: - 📁 Workspace Directory: You'll be prompted to choose a directory where Griptape Nodes will store configurations, project files, secrets (
.env), and generated assets. You can accept the default (<current_directory>/GriptapeNodes) or specify a custom path. - 🔑 Griptape Cloud API Key: Return to the Griptape Nodes setup page in your browser, click "Generate API Key", copy the key, and paste it when prompted in the terminal.
- The first time you run the engine command (
-
🚀 Start the Engine: After configuration, start the engine by running:
griptape-nodes
(or the shorter alias
gtn) -
🔗 Connect Workflow Editor: Refresh the Griptape Nodes Workflow Editor page in your browser. It should now connect to your running engine.
You're now ready to start building flows! 🎉 For more detailed setup options and troubleshooting, see the full Documentation.
3 maintainers
Release files for griptape-nodes-engine 0.102.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| griptape_nodes_engine-0.102.1.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| griptape_nodes_engine-0.102.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.0 MB
Release files / griptape_nodes_engine-0.102.1.tar.gz
| Download URL | griptape_nodes_engine-0.102.1.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae6705c1c7c487254e919e52e154c89a94179776b6d017504e68bf9328061370
|
|
BLAKE2b-256 checksum How to use checksums |
1005f6871ab7b22c6b89cb755bb78b80bfd0e89ed61865545bed18615b23e2c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / griptape_nodes_engine-0.102.1-py3-none-any.whl
| Download URL | griptape_nodes_engine-0.102.1-py3-none-any.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3ebf330957364787574f582245e07ee66b3dd593890a5f61a0a8d0d83ebdaed
|
|
BLAKE2b-256 checksum How to use checksums |
8e14c94672e6cfb1322c0c235c249e5283799c7aa2c90d724d83c9e329b03be3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
