Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

HiveMind Plugin Manager

Full documentation: docs/README.md | Getting Started | Concepts | API Reference | Contributing

The HiveMind Plugin Manager (HPM) discovers, manages, and loads plugins for the HiveMind ecosystem. It defines plugin types for databases, network protocols, agent protocols, binary data handlers, and admission policies. HPM loads these plugins at runtime, so HiveMind agents can swap a backend without changing core code.

Features

  • Plugin discovery: find and load plugins of different types, including:

    • Database plugins: JSON, SQLite, and Redis.
    • Agent protocol plugins: OVOS and Persona, for communication between HiveMind agents.
    • Network protocol plugins: WebSockets, for distributed communication.
    • Binary data handler plugins: binary data communication, like audio data over HiveMind.
  • Plugin loading: load a specific plugin by name, type, or from an available entry point.

  • Factories for plugin instantiation: each plugin type (database, agent protocol, network protocol, binary protocol) has a factory that creates instances from a user configuration.

Installation

pip install hivemind-plugin-manager

Usage

The examples below show how to discover and load plugins, and how to create instances with the provided factories.

Discovering plugins

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

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 factory class that creates plugin instances with the required configuration.

Database Plugin Factory

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

from hivemind_plugin_manager import AgentProtocolFactory

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

Network Protocol Factory

from hivemind_plugin_manager import NetworkProtocolFactory

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

Binary Data Handler Protocol Factory

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

HiveMind Plugin Manager

1. Database plugins

Supports multiple database systems:

2. Agent protocol plugins

Supports communication protocols for agents:

3. Network protocol plugins

Supports network communication protocols:

4. Binary data handler protocol plugins

Handles binary data, like audio, with a specialized protocol (hivemind-audio-binary-protocol).

License

See LICENSE.md.

Metadata

Release files for hivemind-plugin-manager 0.11.1a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hivemind-plugin-manager 0.11.1a1
File Size Uploaded Provenance Actions
hivemind_plugin_manager-0.11.1a1.tar.gz 34.3 kB Without provenance Details for hivemind_plugin_manager-0.11.1a1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hivemind-plugin-manager 0.11.1a1
File Interpreter ABI Platform Actions
hivemind_plugin_manager-0.11.1a1-py3-none-any.whl Python 3 none any Details for hivemind_plugin_manager-0.11.1a1-py3-none-any.whl

Total release size: 58.4 kB

Release files / hivemind_plugin_manager-0.11.1a1.tar.gz

Download URL hivemind_plugin_manager-0.11.1a1.tar.gz
Size 34.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6a870e74f5f3be8e49bd93d1f200767376372d35876b85f18fbab93dfb020c50
BLAKE2b-256 checksum
How to use checksums
705c4de5275c4a021b1a31285ff39dd0f4c21f801aaef2b722fd5b758c3026e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / hivemind_plugin_manager-0.11.1a1-py3-none-any.whl

Download URL hivemind_plugin_manager-0.11.1a1-py3-none-any.whl
Size 24.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9129e27b163729784ef7fa49b9f706327ec4bdf7280aa46ab70592f24f9215d2
BLAKE2b-256 checksum
How to use checksums
8606a32fcd4f9a9c47de22c71f1b743d7d4d72d1d37ce775015193dc39d8c72f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for hivemind-plugin-manager 0.11.1a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page