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.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.100.0.tar.gz | 580.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| griptape_nodes-0.100.0-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| griptape_nodes-0.100.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.100.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.100.0-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| griptape_nodes-0.100.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.4 MB
Release files / griptape_nodes-0.100.0.tar.gz
| Download URL | griptape_nodes-0.100.0.tar.gz |
|---|---|
| Size | 580.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8fa3d690689b5353fda69ab6bc0f85f9bb3222e0c537887e48d6d812aef81246
|
|
BLAKE2b-256 checksum How to use checksums |
135b0865aba401e03127e96ff6420cd0305bfe3136ab464b8edc76e9c3c7dc3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.0-cp312-cp312-win_amd64.whl
| Download URL | griptape_nodes-0.100.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0e3d5fffaf1bbefb84637f7f4708e6159f268a3923f407970940debc093b4161
|
|
BLAKE2b-256 checksum How to use checksums |
7bbf7c9aa66c846082e3e79fec1bdf81e2aea71e5df4468118ecd8e77ed1fb53
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | griptape_nodes-0.100.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 |
6a5a1032d363b6af84b0e247ebf4ca31b1e47b58ee27a6c9cf8ca3aa5ad51fef
|
|
BLAKE2b-256 checksum How to use checksums |
c882579e4a6795f0ab89754b371c97105d6a75a9ac799008106258a0f746e3a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | griptape_nodes-0.100.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 |
64cee6588991f8cef700321ceabea8e3571a5f9a44e8557d412b1875c2070df2
|
|
BLAKE2b-256 checksum How to use checksums |
d4594b25ee156ab543f57124266b3680a0799778ca2e4147602c4db39e6dbcb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | griptape_nodes-0.100.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 |
71a9c3d6d2243c78e46ae09b578aa54bcdc1b8a8f81daef5ad171b83e700394d
|
|
BLAKE2b-256 checksum How to use checksums |
c1a9435c5e71f0290b94d2bef949665a32e625dba07be66d1778939bb36d71fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.0-cp312-cp312-macosx_10_12_x86_64.whl
| Download URL | griptape_nodes-0.100.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 |
ff84a242416854a33f55a953390a40556f09d8256c965bf6528ad98bf5e12ae2
|
|
BLAKE2b-256 checksum How to use checksums |
072270e28c17f5b15a0b159054d703bbf0d062f85a2052dea8e3f42ad3a5edd4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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}
|
