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.100.2
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.100.2.tar.gz | 580.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| griptape_nodes-0.100.2-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| griptape_nodes-0.100.2-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.100.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ ARM64 | Details |
| griptape_nodes-0.100.2-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| griptape_nodes-0.100.2-cp312-cp312-macosx_10_12_x86_64.whl | CPython 3.12 | CPython 3.12 | macOS 10.12+ x86-64 | Details |
Total release size: 42.5 MB
Release files / griptape_nodes-0.100.2.tar.gz
| Download URL | griptape_nodes-0.100.2.tar.gz |
|---|---|
| Size | 580.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e33b4913e6f7cc1362c94d1a959245d1afd339e1bb4261f178689aa0ec07bbe0
|
|
BLAKE2b-256 checksum How to use checksums |
ff0099bca47cea6d143aa6607119699f1b9e9f6ac129f716c482de24b7dee7f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.100.2-cp312-cp312-win_amd64.whl
| Download URL | griptape_nodes-0.100.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
04809ef39c22681baaf53e9d37eaa4c1dbbc8c41330f852f5cea04e30689b35d
|
|
BLAKE2b-256 checksum How to use checksums |
73f54690a40697bf8071f32a73700adae5f40a7b55c77baddd0b390eb07012a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.100.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | griptape_nodes-0.100.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
0c00b4dd2da640848f6a3d7ebec6db8fd3696b3641c7bb93215d4f9f8429cc3f
|
|
BLAKE2b-256 checksum How to use checksums |
748aa9bd497bf5d69765784360244078d8b7241f216b1f3d49b22e77a99e2a04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.100.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | griptape_nodes-0.100.2-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 |
ad5aa2bffeb5052b1f403f0a2d07187323dcafc6f04537ecc8f18b3d3a49cb91
|
|
BLAKE2b-256 checksum How to use checksums |
459b69de99778b335d4aef0d0033998898d75d837d9d3e55b1b210f27b0cdd28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.100.2-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | griptape_nodes-0.100.2-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 |
0dd861b0537b7859d5619646c2afa452a2180379c8180508bd8c1f3204789812
|
|
BLAKE2b-256 checksum How to use checksums |
1bdcaab065860f0fd8ba245ea8382f7f63bf6e6e311c4e7f570be4acb9a8853d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.100.2-cp312-cp312-macosx_10_12_x86_64.whl
| Download URL | griptape_nodes-0.100.2-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 |
bac4420e1ac0dd38a81d8a4e8d07933b3f665abf4a4f2209a227dc75cc408d1a
|
|
BLAKE2b-256 checksum How to use checksums |
042c3bf54d380ad3712ec4dd9aab121c09dc520795cd8893b6b71d3814ea0b4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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}
|
