Skip to main content

Modular Python framework for LLM workflows, tools, memory, and data.

Project description


PyPI Version Tests Docs Griptape Discord

Griptape offers developers the ability to build AI systems that operate across two dimensions: predictability and creativity.

For predictability, software structures like sequential pipelines and directed acyclic graphs (DAGs) are enforced. Creativity, on the other hand, is facilitated by safely prompting LLMs with tools that connect to external APIs and data sources. Developers can move between these two dimensions according to their use case.


Please refer to Griptape Docs for:

  • Getting started guides.
  • Core concepts and design overviews.
  • Examples.
  • Contribution guidelines.

Quick Start

First, install griptape and griptape-tools:

pip install griptape griptape-tools -U

Second, configure an OpenAI client by getting an API key and adding it to your environment as OPENAI_API_KEY. By default, Griptape uses OpenAI Completions API to execute LLM prompts.

With Griptape, you can create structures, such as Agents, Pipelines, and Workflows, that are composed of different types of tasks. Let's build a simple creative agent that dynamically uses two tools with shared memory.

from griptape.memory.tool import TextToolMemory
from griptape.structures import Agent
from import TextProcessor, WebScraper
from griptape.utils import Conversation

Define memory to be shared between tools.
memory = TextToolMemory()

WebScraper enables LLMs to load web pages.
web_scraper = WebScraper(
    memory={"get_content": {"output": [memory]}}

TextProcessor enables LLMs to query
large chunks of text stored in memory
text_processor = TextProcessor(
    memory={"search": {"input": [memory]}}

Agents can use multiple tools to creatively solve problems
agent = Agent(
    tools=[web_scraper, text_processor]
    "based on, tell me what Griptape is"


And here is the output:

Q: based on, tell me what Griptape is
A: Griptape is an opinionated Python framework that enables developers to fully harness the potential of LLMs while enforcing strict trust boundaries, schema validation, and activity-level permissions. It offers developers the ability to build AI systems that operate across two dimensions: predictability and creativity. Griptape can be used to create conversational and autonomous agents.

During the run, the Griptape agent loaded a webpage, stored its content in temporary memory, and passed the memory to TextProcessor to query it.


Griptape is in early development and its APIs and documentation are subject to change. Until we stabilize the API and release version 1.0.0, we will use minor versions (i.e., x.Y.z) to introduce features and breaking features, and patch versions (i.e., x.y.Z) for bug fixes.


Contributions in the form of bug reports, feature ideas, or pull requests are super welcome! Take a look at the current issues and if you'd like to help please submit a pull request with some tests.


Griptape is available under the Apache 2.0 License.

Project details

Download files

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

Source Distribution

griptape-0.10.2.tar.gz (41.3 kB view hashes)

Uploaded source

Built Distribution

griptape-0.10.2-py3-none-any.whl (75.8 kB view hashes)

Uploaded py3

Supported by

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