> ## 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.

# plugins • AI Agent SDK

> Plugin Module for PraisonAI Agents.

# plugins

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

Plugin Module for PraisonAI Agents.

Provides dynamic plugin loading and hook-based extension system.

Features:

* Dynamic plugin discovery and loading
* Hook-based extension points
* Protocol-driven plugin interfaces
* Built-in plugins (logging, metrics)
* Plugin SDK for easy plugin development

Folder Structure:

* plugins/sdk/       - Plugin SDK (base classes, decorators)
* plugins/builtin/   - Built-in plugins (logging, metrics)
* plugins/protocols.py - Plugin protocols for type safety

Usage:
from praisonaiagents.plugins import PluginManager, Plugin, PluginHook

# Create plugin manager

manager = PluginManager()

# Load plugins from directory

manager.load\_from\_directory("./plugins")

# Use built-in plugins

from praisonaiagents.plugins.builtin import LoggingPlugin, MetricsPlugin
manager.register(LoggingPlugin())

# Use plugin SDK

from praisonaiagents.plugins.sdk import plugin

@plugin(name="my\_plugin", hooks=\[PluginHook.BEFORE\_TOOL])
def my\_plugin\_func(hook\_type, \*args, \*\*kwargs):
return args\[0] if args else None

## Import

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

## Functions

<CardGroup cols={2}>
  <Card title="enable()" icon="function" href="../functions/enable">
    Enable the plugin system.
  </Card>

  <Card title="disable()" icon="function" href="../functions/disable">
    Disable plugins.
  </Card>

  <Card title="list_plugins()" icon="function" href="../functions/list_plugins">
    List all discovered plugins.
  </Card>

  <Card title="is_enabled()" icon="function" href="../functions/is_enabled">
    Check if plugins are enabled.
  </Card>
</CardGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Plugins Feature" icon="plug" href="/docs/features/plugins" />
</CardGroup>
