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.9

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.9
File	Size	Uploaded
gumloop-0.4.9.tar.gz	233.4 kB	Sep 4, 2026	Details

Built distribution (wheel)

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

Total release size: 343.6 kB

Release files / gumloop-0.4.9.tar.gz

Download URL	gumloop-0.4.9.tar.gz
Size	233.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`a6d61c0379daf8a5914ed27d789c573e225bc50aefd7264a27690f1441faef5f`
BLAKE2b-256 checksum How to use checksums	`810aca5aced1489686ad2d9e181e745fd79be2022548fe2778125a439463ee2a`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","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.9-py3-none-any.whl

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