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.
✨ 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/
🧩 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.
📜 Licensing
Griptape Nodes is proprietary, commercial software. © 2024–2026 The Foundry Visionmongers Ltd. All rights reserved. Installing or using this package constitutes acceptance of the Foundry End User Licence Agreement; see the LICENSE file distributed with this package for full terms. For licensing enquiries, contact legal@foundry.com.
💬 Support
- 📚 Documentation: docs.griptapenodes.com
- 🐛 Issues: github.com/griptape-ai/griptape-nodes-app/issues
- 💬 Community: Discord
4 maintainers
Metadata
4 maintainers
Release files for griptape-nodes 0.97.0
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-0.97.0.tar.gz | 539.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| griptape_nodes-0.97.0-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| griptape_nodes-0.97.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ x86-64 | Details |
| griptape_nodes-0.97.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ ARM64 | Details |
| griptape_nodes-0.97.0-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| griptape_nodes-0.97.0-cp312-cp312-macosx_10_12_x86_64.whl | CPython 3.12 | CPython 3.12 | macOS 10.12+ x86-64 | Details |
Total release size: 42.2 MB
Release files / griptape_nodes-0.97.0.tar.gz
| Download URL | griptape_nodes-0.97.0.tar.gz |
|---|---|
| Size | 539.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9608783b83b3f7044f6388af3276829a75049cf2d4a07925aaf289caaa891afe
|
|
BLAKE2b-256 checksum How to use checksums |
0a5e3b6ffb9ac1dd96e54872576ad61a0b89e82f75f80ef182836a0058984cdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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-0.97.0-cp312-cp312-win_amd64.whl
| Download URL | griptape_nodes-0.97.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0ccfbe5440b787c7446d83e770490ca3f057e9d712b4249f777e53fb5a155115
|
|
BLAKE2b-256 checksum How to use checksums |
b284cf9b89fba63e4a45bdd51ea029918d859e7bcc7675f0355e20e5fbb9d718
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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-0.97.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | griptape_nodes-0.97.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 10.1 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
ea77f2c828fdd03d089b46c8dced0438a659b5df425a54a50226efd46549e228
|
|
BLAKE2b-256 checksum How to use checksums |
ee9ecea1480481db712273f7a575e084101629d8f2607a7d940bf4c6d0229e99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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-0.97.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | griptape_nodes-0.97.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 10.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
5794363a853a4006b9ee33e97e6df49441fa542075d0a5ff4a018825a5b4eca6
|
|
BLAKE2b-256 checksum How to use checksums |
e2abb70d0eb0644828f64ccdda159a51b96e7cb9f69ee2db23b54ae1220c8c02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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-0.97.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | griptape_nodes-0.97.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.1 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0da6339fdc64c6bbf1f149164c3fe4dc3d9be52fd498904f429a5f64104f48e2
|
|
BLAKE2b-256 checksum How to use checksums |
a30597c19148c13edd8c47f6db6bc7699d49fd190d2d14c6db870c0fd2549f09
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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-0.97.0-cp312-cp312-macosx_10_12_x86_64.whl
| Download URL | griptape_nodes-0.97.0-cp312-cp312-macosx_10_12_x86_64.whl |
|---|---|
| Size | 7.3 MB |
| Tags | CPython 3.12 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
abf5fa2d017c473d76fc1b2643e060c5ace10f15a258e4c0b15230850d022ecb
|
|
BLAKE2b-256 checksum How to use checksums |
156f6c0d6e00195dfe48be2896bc643ab7b705a78fc7f94ab6ff5daca9e05d5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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}
|
