Fishjam Python Server SDK

fishjam-server-sdk on PyPI; import fishjam. Server-side Python SDK for Fishjam.

Read ../platform/SKILL.md first. It defines rooms, peers, tracks, the two-tier token model, and the WS-vs-webhook tradeoff that the Python SDK is built on.

Sync REST + async events

The architecture differs from the JS SDK in one important way:

• FishjamClient is synchronous. Methods like create_room, create_peer, delete_peer are plain def, not async def. Call them from sync routes or via run_in_executor from async contexts.
• FishjamNotifier is async (asyncio + websockets). Use @notifier.on_server_notification and await notifier.connect().
• Agent is async (async context manager — async with agent.connect() as session: ...).
• receive_binary(raw_bytes) is sync — call it directly inside an async route handler or a sync one.

Install + minimal flow