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.8.tar.gz (466.0 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.8-py3-none-any.whl (620.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: griptape_nodes-0.63.8.tar.gz
  • Upload date:
  • Size: 466.0 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.8.tar.gz
Algorithm Hash digest
SHA256 8af91303350c4fcffb21fe138119e51a37ee6a06e680868e85a558871cd380a0
MD5 92a6b7d08867be64f68e255ac8244eeb
BLAKE2b-256 a7d8b89f5a317e7ad34cdcbf6a11271a6aa0edb46aab169aa45ec4b896e726a2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: griptape_nodes-0.63.8-py3-none-any.whl
  • Upload date:
  • Size: 620.1 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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 9b484b00466af73215aeb6d02705a6c89eb2371d0ff6bf83725bd76a9f643543
MD5 7bbfbe8113a825435caa49876e77caf3
BLAKE2b-256 76695d5a62129d29bdaf8a9805f39a42e8df7535eab089c9a45ee6e58a5719cf

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