rekuest

The distributed runtime for Arkitekt apps.

An Arkitekt app is a declaration: the actions, states and hooks it offers. The declaration itself is arkitekt-spec's, and executing it locally is arkitekt-runtime's. rekuest adds what running it distributed takes:

an agent that registers the declaration with a rekuest server over a websocket, is assigned tasks, and reports their progress, logs and results back;
the caller through which one app's actions call other apps' actions via the server;
Rekuest, the GraphQL client for the server: find actions and implementations, call them, and watch their tasks.

You rarely import rekuest yourself. run(app) in arkitekt uses it, and the names an app is written with (App, Task, the Annotated markers, the policies) come from arkitekt.

Install

pip install "arkitekt[rekuest]"   # what an app needs to run(app)
pip install rekuest               # just the runtime and client

The optional extras are units (physical-quantity ports, via kanne) and types (annotated-types constraints). rekuest requires Python 3.11+.

Offering actions

Declare the app with arkitekt and run it. run connects it through rekuest's provider, which builds the agent and keeps it offering the app's actions until you stop it:

from arkitekt import App, Task, run

app = App("measure", "0.1.0")


@app.action
def double(x: int, task: Task) -> int:
    """Double

    Doubles a number.
    """
    task.log(f"doubling {x}")
    return x * 2


if __name__ == "__main__":
    run(app)

An app can also name the provider explicitly: App(..., providers=[rekuest_provider]) with from rekuest.arkitekt import rekuest_provider.

Calling actions

From a script, name the rekuest service and call an action by its id (or pass an Action/Implementation you looked up). The call is a root task:

from arkitekt import easy
from rekuest.arkitekt import rekuest_service

with easy("my-script", rekuest_service) as rekuest:
    result = rekuest.call("<action-id>", x=21)

Inside a running action, a call is a child of the task it runs in, so it goes through the task. Resolve the target with the client, then call it on the task (rekuest.acall inside a task raises RootOnlyCallError, which says as much):

from arkitekt import App, Task
from rekuest.arkitekt import rekuest_service
from rekuest.client.client import Rekuest

app = App("orchestrate", "0.1.0", services=[rekuest_service])


@app.action
async def double_twice(x: int, action_id: str, task: Task, rekuest: Rekuest) -> int:
    """Double Twice"""
    action = await rekuest.aresolve(action_id)
    once = await task.acall(action, x=x)
    return await task.acall(action, x=once)

Actions, implementations, shortcuts, test cases, test results and task events travel between actions by id (@rekuest/action, @rekuest/implementation, …), so an action can take and return them directly.

Package layout

Module	What it is
`rekuest.arkitekt`	The service (`rekuest_service`), the agent provider (`rekuest_provider`) and the `@rekuest/*` structures
`rekuest.agents`	The agent, its websocket transport, control channel and caller
`rekuest.client`	`Rekuest`, the GraphQL client, and its postman
`rekuest.api.schema`	The generated GraphQL operations and types
`rekuest.protocol`	The wire protocol the agent speaks with the server

Guides

Agent dependencies — declare the actions and states an app depends on
Disconnect policy — what happens to in-flight work when the agent loses its connection
The agent journal — the ordered, persisted record of everything an agent reports

Development

uv sync                       # install dependencies
pytest -m "not integration"   # fast unit tests
pytest -m integration         # full integration tests (require Docker)

Integration tests spin up the rekuest stack with Docker Compose and exercise real calls against it; see tests/conftest.py.

Learn more

📚 arkitekt.live
🐙 github.com/arkitektio/rekuest

License

GPL-3.0-or-later

Metadata

Release files for rekuest 6.1.0

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

Source distribution (sdist)

Source distribution for rekuest 6.1.0
File	Size	Uploaded
rekuest-6.1.0.tar.gz	122.5 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for rekuest 6.1.0
File	Interpreter	ABI	Platform	Reset
rekuest-6.1.0-py3-none-any.whl 132.3 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 254.8 kB

Release files / rekuest-6.1.0.tar.gz

Download URL	rekuest-6.1.0.tar.gz
Size	122.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`de81ebfc0e50791efa5aa3353489515685560041b7c122ebb87fb578674b0e2b`
BLAKE2b-256 checksum How to use checksums	`ae2d455cff52496c3d3fe290856a79e0e438c56e83e919efed6b44b8de41f7a2`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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 / rekuest-6.1.0-py3-none-any.whl

Download URL	rekuest-6.1.0-py3-none-any.whl
Size	132.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3106665638cf74d30479761d67a69d5861ec7173c57b7b4715b5668cdd2fed63`
BLAKE2b-256 checksum How to use checksums	`870d92c4c2e783f3ee98dde46947ff2ce58d9a05721ff59c612f8e6a9f5f4f58`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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}`