> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# bus • AI Agent SDK

> Event Bus Module for PraisonAI Agents.

# bus

<Badge color="blue">AI Agent</Badge>

Event Bus Module for PraisonAI Agents.

Provides a typed publish/subscribe event system for real-time communication
between components. Extends the existing hooks system with a more general
event-driven architecture.

Features:

* Typed event definitions with dataclass payloads
* Sync and async subscribers
* Event filtering by type
* Global and scoped event buses
* SSE-compatible event streaming

Zero Performance Impact:

* All imports are lazy loaded
* No overhead when not subscribed
* Optional dependency for server features

Usage:
from praisonaiagents.bus import EventBus, Event

# Create event bus

bus = EventBus()

# Subscribe to events

@bus.on("session.created")
def handle\_session(event):
print(f"Session created: \{event.data}")

# Publish events

bus.publish("session.created", \{"session\_id": "abc123"})

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import bus
```