Khan is the "control plane" and thread-runner vane. Its main purpose is to allow external applications to run threads via a Unix Socket and receive the result.

At this stage, Khan's external interface is still experimental, and there are not yet proper libraries for other languages that can make use of it. Therefore, these documents will only touch on Khan's internal interface.

Khan's internal interface lets you run threads via Khan rather than having to poke Spider and subscribe for the result. This interface is simpler and more ergonomic than Spider's, so is usually preferable.

There are currently three tasks to run a thread: %fard, %fyrd, and %lard. Only %fard is currently documented in the API Reference section, and a practical example is given in the Example section.

Sections

Data Types - Reference documentation of the data types used by Khan.

API Reference - The tasks Khan takes and the gifts it returns.

Example - An example of using Khan to run a thread from a Gall agent and receive its result.