Gumloop Python Client

A Python client for the Gumloop API that makes it easy to run and monitor Gumloop flows, plus the gumloop CLI.

CLI

Install on macOS or Linux:

curl -fsSL https://gumloop.com/cli/install.sh | sh

The installer is fully self-contained under ~/.gumloop — it ships its own Python, never touches your system Python, and needs no sudo. Run gumloop --help to get started and update any time with:

gumloop update

SDK

To use the client as a library in your own Python project:

uv add gumloop

Usage

from gumloop import GumloopClient

# Initialize the client
client = GumloopClient(
    api_key="your_api_key",
    user_id="your_user_id"
)

# Run a flow and wait for outputs
output = client.run_flow(
    flow_id="your_flow_id",
    inputs={
        "recipient": "example@email.com",
        "subject": "Hello",
        "body": "World"
    }
)

print(output)

Authenticate with a team API key

Team (workspace) API keys are scoped to a single team. Pass the team's ID and the acting member's user ID — every request is validated against that team and only reaches resources the team owns.

from gumloop import Gumloop

client = Gumloop(
    api_key="your_team_api_key",
    user_id="your_user_id",  # must be a member of the team
    team_id="your_team_id",
)

agents = client.agents.list()  # scoped to the team

team_id can also be provided via the GUMLOOP_TEAM_ID environment variable.

Chat with an agent (streaming)

import asyncio

from gumloop import AsyncGumloop


async def main() -> None:
    async with AsyncGumloop(access_token="your_access_token") as client:
        agents = await client.agents.list()
        agent = agents.agents[0]

        async for event in client.sessions.stream(
            agent.id,
            input="Hello, what can you do?",
        ):
            print(event)


asyncio.run(main())

Metadata

Release files for gumloop 0.4.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gumloop 0.4.10
File	Size	Uploaded
gumloop-0.4.10.tar.gz	234.6 kB	Sep 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gumloop 0.4.10
File	Interpreter	ABI	Platform	Reset
gumloop-0.4.10-py3-none-any.whl 111.4 kB Sep 11, 2026	Python 3	none	any	Details

Total release size: 346.0 kB

Release files / gumloop-0.4.10.tar.gz

Download URL	gumloop-0.4.10.tar.gz
Size	234.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`a0930ad651c339a76a2443637330f33b52e01adceaefe8bc322e07350271058c`
BLAKE2b-256 checksum How to use checksums	`16419af31d9e8f29eceb28b8ac248e2d3621e26efb275d7de914ae2826338b03`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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 / gumloop-0.4.10-py3-none-any.whl

Download URL	gumloop-0.4.10-py3-none-any.whl
Size	111.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c1571fa69d2ebfd3139627f50372008e310ca381fc0c6a44013b668ac457ef0f`
BLAKE2b-256 checksum How to use checksums	`e48e1756e04517d9300cfcc5dc55d65620108a83a738d1aeaca843094e36dd2d`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}`