Documentation

sdk

Python SDK

In-guest fabric client (fystash.FystashClient). Control-plane HTTP is typically via MCP or raw REST.

import asyncio
from fystash import FystashClient

async def main() -> None:
    async with FystashClient.tcp(
        "127.0.0.1",
        7447,
        room_id="demo",
        agent_id="worker-a",
    ) as client:
        response = await client.request("worker-b", b"hello", timeout=5)
        print(response.payload)

asyncio.run(main())

Registration

registration_mode="auto":

  • TCP → direct (SDK sends Register)
  • Unix → daemon (guest daemon owns identity)

For room create / from-template / exec from outside the guest, use MCP or REST.