Python SDK for the SLOP protocol.
The package includes provider and consumer APIs, descriptor helpers, tree scaling utilities, and transports for ASGI, WebSocket, Unix socket, and stdio flows.
pip install slop-ai[websocket]Use the websocket extra when you want the standalone WebSocket transport. The core package itself has no required runtime dependencies.
from fastapi import FastAPI
from slop_ai import SlopServer
from slop_ai.transports.asgi import SlopMiddleware
app = FastAPI()
slop = SlopServer("my-api", "My API")
@slop.node("todos")
def todos_node():
return {
"type": "collection",
"items": [
{"id": str(todo.id), "props": {"title": todo.title, "done": todo.done}}
for todo in db.get_todos()
],
}
@slop.action("todos", "create", params={"title": "string"})
def create_todo(title: str):
db.create_todo(title)
app.add_middleware(SlopMiddleware, slop=slop)slop_ai.SlopServerandslop_ai.SlopConsumerslop_ai.discoveryfor provider scanning, bridge relay, lazy/auto-connect, and AI-facing tool helpersslop_ai.pick,slop_ai.omit,slop_ai.expose_store,slop_ai.normalize_descriptorslop_ai.transports.asgi,.websocket,.unix,.stdio- scaling helpers such as
prepare_tree,truncate_tree, andauto_compact
The Python SDK includes the core discovery layer in slop_ai.discovery:
import asyncio
from slop_ai.discovery import DiscoveryOptions, create_discovery_service
async def main() -> None:
service = create_discovery_service(DiscoveryOptions())
await service.start()
try:
provider = await service.ensure_connected("my-app")
if provider is not None:
print(provider.name)
finally:
await service.stop()
asyncio.run(main())Install slop-ai[websocket] when discovery needs browser bridge support or direct WebSocket providers.
- API reference: https://docs.slopai.dev/api/python
- Python guide: https://docs.slopai.dev/guides/python
- Protocol spec: https://docs.slopai.dev/spec/core/overview