Gestell Python SDK

A fully featured SDK with extensive code completion and typesystems for interacting with the Gestell Platform. Full featured support for Python 3.X. Uses asynchronous coroutines by design.

Quick Start

First, get an API Key from https://platform.gestell.ai. Then install gestell:

pip install gestell

Or...

uv add gestell

Second, load the API Key into your terminal session, or, pass it into the SDK:

# Load it into your terminal session
export GESTELL_API_KEY = "..."

Or load it directly in the client:

from gestell import Gestell
gestell = Gestell(key='...', url='...', debug=True)

Gestell will also read and load these environment variables from a .env file.

Finally, start using the Gestell Platform SDK. The SDK can be used both on the client and server side. A public facing app should use it server side only due to the API Key being passed into the SDK and requests:

import asyncio
from typing import List
from gestell import Gestell
from gestell.types import Collection


gestell = Gestell()


async def main():
    response = await gestell.collection.list()
    collections: List[Collection] = response.result
    print(collections)


if __name__ == "__main__":
    asyncio.run(main())

Guide

You can review guides on common workflows and use cases for the Gestell Platform by going to https://gestell.ai/docs. There is a full guide to create, prompt, search and gather labels and tables at https://gestell.ai/docs/guide.

Review the Contributing Guidelines to see how to test and contribute features to the SDK.

Review the CHANGELOG to see updates and/or improvements to the SDK.