trigora-client

Python client for starting and controlling Trigora durable executions.

Use the same API locally with trigora dev or remotely with Trigora Cloud.

Install

pip install trigora-client

Quick example

from trigora_client import Client

client = Client()

run = client.executions.start("approval", {"request": "example"})
run.send("approved", "ok")
result = run.result()

print(result)

Local and Cloud

By default, the client connects to the local runtime started by trigora dev.

client = Client()

To connect to Trigora Cloud:

client = Client(remote=True)

Cloud requires a token. You can pass one directly or set TRIGORA_TOKEN.

import os

client = Client(remote=True, token=os.environ["TRIGORA_TOKEN"])

You can also connect to a custom endpoint:

client = Client(url="http://127.0.0.1:3477")

Endpoint defaults:

• Local runtime: TRIGORA_RUNTIME_URL or http://127.0.0.1:3477
• Trigora Cloud: TRIGORA_API_BASE_URL or https://api.trigora.dev

An explicit url overrides the default endpoint. An explicit token is sent with requests to that endpoint.

API

Workspace and project operations:

• whoami()
• projects.list()
• projects.create()

Programs:

• deploy()
• programs.list()
• programs.get()
• programs.versions()

Executions:

• executions.start(program, input)
• executions.list()
• executions.get(id)

Execution handle:

• run.id
• run.send(event, payload)
• run.cancel()
• run.result()

programs.list, programs.versions, and executions.list accept optional limit and cursor arguments.

program is a program id string.

event is an event name string.

Learn more

• Trigora documentation
• Client documentation
• Trigora Cloud

License

MIT © 2026 Trigora, Inc.