Metadata-Version: 2.4
Name: hivemind-plugin-manager
Version: 0.8.0a1
Summary: plugin manager for hivemind-core
Author-email: jarbasAI <jarbasai@mailfence.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/JarbasHiveMind/hivemind-plugin-manager
Keywords: hivemind,plugins,plugin-manager
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: hivemind_bus_client
Requires-Dist: json_database>=0.10.2a1
Requires-Dist: ovos-bus-client
Requires-Dist: ovos-utils
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# HiveMind Plugin Manager

> **Full documentation:** [docs/README.md](docs/README.md)
> — [Getting Started](docs/getting-started.md)
> | [Concepts](docs/concepts.md)
> | [API Reference](docs/api-reference.md)
> | [Contributing](docs/contributing.md)

The **HiveMind Plugin Manager (HPM)** is a system for discovering, managing, and loading plugins within the HiveMind ecosystem. It supports various plugin types, including databases, network protocols, agent protocols, and binary data handlers. HPM allows for dynamic integration of these plugins to enhance the functionality of HiveMind agents, offering a flexible and extensible architecture.

## Features

- **Plugin Discovery**: Easily find and load plugins of different types, including:
  - **Database Plugins**: Supports various database types such as JSON, SQLite, and Redis.
  - **Agent Protocol Plugins**: Integrates agent protocols like OVOS and Persona, enabling seamless communication between HiveMind agents.
  - **Network Protocol Plugins**: Enables network protocols such as WebSockets for distributed communication.
  - **Binary Data Handler Plugins**: Handle binary data communication, like audio data over HiveMind.

- **Plugin Loading**: Dynamically load specific plugins by name, type, or from available entry points.

- **Factories for Plugin Instantiation**: Factories for creating instances of each plugin type (database, agent protocol, network protocol, binary protocol) based on user configurations.


## Installation

```bash
pip install hivemind-plugin-manager
```

## Usage

The following example demonstrates how to discover and load plugins, along with creating instances using the provided factories.

### Discovering Plugins

Use the `find_plugins` function to discover all available plugins for a specific type:

```python
from hivemind_plugin_manager import find_plugins, HiveMindPluginTypes

# Find all database plugins
database_plugins = find_plugins(HiveMindPluginTypes.DATABASE)
print(database_plugins)

# Find all agent protocol plugins
agent_protocol_plugins = find_plugins(HiveMindPluginTypes.AGENT_PROTOCOL)
print(agent_protocol_plugins)
```

### Creating Plugin Instances

Each plugin type has a corresponding factory class that allows for creating plugin instances with the required configuration.

#### Database Plugin Factory

```python
from hivemind_plugin_manager import DatabaseFactory

# Create an instance of a database plugin
db_instance = DatabaseFactory.create("hivemind-redis-db-plugin", password="Password1!", host="192.168.1.11", port=6789)
```

#### Agent Protocol Factory

```python
from hivemind_plugin_manager import AgentProtocolFactory

# Create an agent protocol instance
agent_protocol_instance = AgentProtocolFactory.create("hivemind-ovos-agent-plugin")
```

#### Network Protocol Factory

```python
from hivemind_plugin_manager import NetworkProtocolFactory

# Create a network protocol instance
network_protocol_instance = NetworkProtocolFactory.create("hivemind-websocket-plugin")
```

#### Binary Data Handler Protocol Factory

```python
from hivemind_plugin_manager import BinaryDataHandlerProtocolFactory

# Create a binary data handler protocol instance
binary_data_handler_instance = BinaryDataHandlerProtocolFactory.create("hivemind-audio-binary-protocol-plugin")
```

## Plugin Types

<div align="center">
  <img src="https://github.com/user-attachments/assets/160ebc5c-da61-4175-98dd-ade24bb218e3" alt="HiveMind Plugin Manager" width="800">
</div>

### 1. **Database Plugins**

Supports multiple database systems, such as:

- **JSON Database**: Stores data in a JSON format.
- **SQLite Database**: Uses SQLite for local database storage.
- **Redis Database**: Uses Redis for distributed caching and storage.

### 2. **Agent Protocol Plugins**

Supports communication protocols for agents, such as:

- **OVOS Protocol**: For interaction with OVOS-based agents.
- **Persona Protocol**: For interaction with the Persona framework.

### 3. **Network Protocol Plugins**

Enables network communication protocols, such as:

- **WebSocket Protocol**: For real-time, bidirectional communication over WebSockets.

### 4. **Binary Data Handler Protocol Plugins**

Handles communication of binary data types, like audio, using specialized protocols.
