iii-sdk

Python SDK for the iii engine.

Install

pip install iii-sdk

Hello World

from iii import register_worker

iii = register_worker("ws://localhost:49134")

def greet(data):
    return {"message": f"Hello, {data['name']}!"}

iii.register_function("hello::greet", greet)

iii.register_trigger({
    "type": "http",
    "function_id": "hello::greet",
    "config": {"api_path": "/greet", "http_method": "POST"},
})

iii.connect()

result = iii.trigger({"function_id": "hello::greet", "payload": {"name": "world"}})
print(result)  # {"message": "Hello, world!"}

API

Operation	Signature	Description
Initialize	`register_worker(url, options?)`	Create an SDK instance and auto-connect
Register function	`iii.register_function(id, handler)`	Register a function that can be invoked by name
Register trigger	`iii.register_trigger({"type": ..., "function_id": ..., "config": ...})`	Bind a trigger (HTTP, cron, queue, etc.) to a function
Invoke (await result)	`iii.trigger({"function_id": id, "payload": data})`	Invoke a function and wait for the result
Invoke (fire-and-forget)	`iii.trigger({"function_id": id, ..., "action": TriggerAction.Void()})`	Fire-and-forget
Invoke (enqueue)	`iii.trigger({"function_id": id, ..., "action": TriggerAction.Enqueue(queue="name")})`	Route invocation through a named queue
Shutdown	`iii.shutdown()`	Disconnect and stop background thread

register_worker() creates the SDK instance and auto-connects to the engine.

Registering Functions

def create_order(data):
    return {"status_code": 201, "body": {"id": "123", "item": data["body"]["item"]}}

iii.register_function("orders::create", create_order)

Registering Triggers

iii.register_trigger({
    "type": "http",
    "function_id": "orders::create",
    "config": {"api_path": "/orders", "http_method": "POST"},
})

Invoking Functions

result = iii.trigger({"function_id": "orders::create", "payload": {"body": {"item": "widget"}}})

Development

Install in development mode

pip install -e .

Type checking

mypy src

Linting

ruff check src

Resources

Metadata

Release files for iii-sdk 0.24.3a2

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

Source distribution (sdist)

Source distribution for iii-sdk 0.24.3a2
File	Size	Uploaded
iii_sdk-0.24.3a2.tar.gz	202.4 kB	Sep 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for iii-sdk 0.24.3a2
File	Interpreter	ABI	Platform	Reset
iii_sdk-0.24.3a2-py3-none-any.whl 42.5 kB Sep 28, 2026	Python 3	none	any	Details

Total release size: 244.9 kB

Release files / iii_sdk-0.24.3a2.tar.gz

Download URL	iii_sdk-0.24.3a2.tar.gz
Size	202.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`979c47c9ff59363b5d9f3b1a9a3f5df3364b17e22f196d6740b101e5f1dfc637`
BLAKE2b-256 checksum How to use checksums	`7d0cdd2b5afc12db14cb4fe07d484023a9f79a155b95ef05e3fcaf51fc933e6f`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / iii_sdk-0.24.3a2-py3-none-any.whl

Download URL	iii_sdk-0.24.3a2-py3-none-any.whl
Size	42.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`398485c8a96efecd3b364f3d5f38ae3c5800ac17797834f87b9586c06124dd59`
BLAKE2b-256 checksum How to use checksums	`af4a4d6d375c98c724ff4bff608c1b16c14c50a3b891e8ca22b414cbec5f1515`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`