Skip to main content

Add your description here

Project description

🎨 Griptape Nodes

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.

Griptape Nodes Trailer Preview (Clicking the image opens the video on Vimeo)

✨ 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:

🧩 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

Follow these steps to get the Griptape Nodes engine running on your system:

  1. 🔐 Login: Visit Griptape Nodes and log in or sign up using your Griptape Cloud credentials.

  2. 💾 Install Command: Once logged in, you'll find a setup screen. Copy the installation command provided in the "New Installation" section. It will look similar to this (use the exact command provided on the website):

    curl -LsSf https://raw.githubusercontent.com/griptape-ai/griptape-nodes/main/install.sh | bash
    
  3. ⚡ Run Installer: Open a terminal on your machine (local or cloud environment) and paste/run the command. The installer uses uv for fast installation; if uv isn't present, the script will typically handle installing it.

  4. ⚙️ Initial Configuration (Automatic on First Run):

    • The first time you run the engine command (griptape-nodes or gtn), 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.
  5. 🚀 Start the Engine: After configuration, start the engine by running:

    griptape-nodes
    

    (or the shorter alias gtn)

  6. 🔗 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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

griptape_nodes-0.63.5.tar.gz (466.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

griptape_nodes-0.63.5-py3-none-any.whl (620.4 kB view details)

Uploaded Python 3

File details

Details for the file griptape_nodes-0.63.5.tar.gz.

File metadata

  • Download URL: griptape_nodes-0.63.5.tar.gz
  • Upload date:
  • Size: 466.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"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}

File hashes

Hashes for griptape_nodes-0.63.5.tar.gz
Algorithm Hash digest
SHA256 cd6aa5910f60814ead11a667a3fd68ca8910c7c43bf2e9cc40b86b900ebbfc85
MD5 961a2dbe7f24a8ec38427d880e30c077
BLAKE2b-256 67c9cd87346fde14a734d208fe8d0f8484e6d3863d1677fbdafce30a88c37fca

See more details on using hashes here.

File details

Details for the file griptape_nodes-0.63.5-py3-none-any.whl.

File metadata

  • Download URL: griptape_nodes-0.63.5-py3-none-any.whl
  • Upload date:
  • Size: 620.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"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}

File hashes

Hashes for griptape_nodes-0.63.5-py3-none-any.whl
Algorithm Hash digest
SHA256 47583e84b7ba4a9807d611dfc62c26df9b7995a1a8801a7594a270299a393835
MD5 85a8b84550f664be34391d60d195e913
BLAKE2b-256 2ff767a74edb20291ce8ce1583307dcdbb4c46f47864afdfa747d4222370345b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page