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.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-0.100.1.tar.gz | 580.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| griptape_nodes-0.100.1-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| griptape_nodes-0.100.1-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.1-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.1-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| griptape_nodes-0.100.1-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.1.tar.gz
| Download URL | griptape_nodes-0.100.1.tar.gz |
|---|---|
| Size | 580.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
907c394d1b8fd5fd2ed484fe7b43317d6e44416e9bb539348009d5aa347f41ab
|
|
BLAKE2b-256 checksum How to use checksums |
a05282a0f9bd5ef187193884d69c5375fae1fc1a58c7f239ecf9282125d7c4f8
|
| 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.1-cp312-cp312-win_amd64.whl
| Download URL | griptape_nodes-0.100.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c15404716cb3c58b2b928a2a457e2bb39d4f4e6304acd59b581c290c9071e104
|
|
BLAKE2b-256 checksum How to use checksums |
3bdeddde5cbd67d5275df420c00fb1b68fad1ee7957cfb3aa3273e4c6a4e0f22
|
| 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.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | griptape_nodes-0.100.1-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 |
e589b06d83fa562fd7247afc429dac213fbfd6c024ed1ab3975a33a29f21649c
|
|
BLAKE2b-256 checksum How to use checksums |
b7b9a73edf980ee51f9df9689f61738d65dd2c41306b1d302a60f3651ad14cad
|
| 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.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | griptape_nodes-0.100.1-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 |
2a75b9f5588d61fb10e4e7ac8d1fe25466d3410dd80c8eb1d6727f807287e93c
|
|
BLAKE2b-256 checksum How to use checksums |
ff90ccdd7edfbc61ea125b5cecc0ce1fc612e81b107353ca7bf56209f5f38c9d
|
| 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.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | griptape_nodes-0.100.1-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 |
ee2a6389e9676fdd58b0b7850a95f9b9c838f5b6aebc9bdf5877e3f0cd957279
|
|
BLAKE2b-256 checksum How to use checksums |
3cab5c8ca81a0b5df1f8b20e5a5f926738727d760c360d2fbb9ffeed6b67d859
|
| 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.1-cp312-cp312-macosx_10_12_x86_64.whl
| Download URL | griptape_nodes-0.100.1-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 |
5a991f367beda995233be18514e0a52ab78558d3d3ae76e295220c29a53b33d7
|
|
BLAKE2b-256 checksum How to use checksums |
6c796307440287f26aeec952bca17f9c9d03ba4f21fd83f708c789e6d4dd11fa
|
| 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}
|
