---
id: pluginbase
version: "1.0.1"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# pluginbase — PluginBase is a module for Python that enables the development of flexible plugin systems in Python.

License: permissive · Maintenance: abandoned · Downloads: 819.1K/mo

## What it is and what it does

PluginBase is a Python module that abstracts the mechanics of discovering and loading plugins from the filesystem. It lets you define a package namespace and search paths, then dynamically import plugin modules at runtime without pre-registering them. The framework handles the import process so your application can treat plugins as regular Python modules once loaded.

Typical use involves three steps: instantiate a PluginBase with a package name, create a plugin source pointing to directories containing plugin code, then load individual plugins by name or import them as context managers. This is useful for applications that need extensibility without requiring users to modify core code or restart the application.

Use it for:

- Build an extensible application where users can drop plugin files into a directory and have them automatically discovered
- Create a command-line tool with optional feature plugins that load on demand from a plugins folder
- Develop a data processing pipeline where transformation steps are implemented as separate plugin modules
- Build a game or graphics application with modular content packs loaded as plugins at startup

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

PluginBase provides a framework for building plugin systems in Python, allowing applications to dynamically load and execute plugins from specified directories.

Yes, if you need a lightweight plugin framework and can accept that the package is no longer maintained. The core functionality is stable and has no known vulnerabilities, but verify compatibility with your target Python version before committing. For new projects, consider whether an actively maintained alternative better suits your needs.

## Install

pip install pluginbase
uv add pluginbase
poetry add pluginbase

## Installing pluginbase

Before you install: High install friction with no runtime dependencies. The package is marked abandoned (last commit 2021-05-16, 1916 days since release), though it remains in production/stable status and has accumulated 1139 repository stars. Use only if plugin architecture is essential and no actively maintained alternative exists.

License in practice: Licensed under BSD (permissive), allowing use in commercial and proprietary projects with minimal restrictions.

Quickstart:

from pluginbase import PluginBase
plugin_base = PluginBase(package='yourapplication.plugins')
plugin_source = plugin_base.make_plugin_source(searchpath=['./plugins'])
my_plugin = plugin_source.load_plugin('my_plugin')
my_plugin.do_something_cool()

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.9 (classifiers list 3.9 as the latest tested)
- Whether abandonment status affects compatibility with modern Python packaging standards

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 819.1K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python plugin system, dynamic plugin loading, plugin framework, extensible application architecture, plugin discovery and loading, modular plugin management, runtime plugin injection, plugin-architecture, dynamic-loading, extensibility

[View on SkillFed](https://skillfed.io/packages/pluginbase) · [View on PyPI](https://pypi.org/project/pluginbase/)