pllmpllm.providers Python API
Public objects, practical usage, and research context for pllm.providers.
Provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation. Presence documents API availability, not complete model, security, or deployment coverage; check implementation status before relying on a path.
Research context
This API is project infrastructure rather than an implementation of one specific paper. Relevant method pages link their primary sources separately.
Python SDK example
The example performs a bounded offline task and checks an observable result. It does not download a checkpoint or contact a provider.
import pllm.providers as providers
# An explicit empty entry-point set disables external package discovery.
assert providers.discover_providers(entry_points=()) == ()API: pllm.providers
Objects and signatures
HOST_COMPONENT_STANDARD_VERSION
Provides the public version value used where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.HOST_COMPONENT_STANDARD_VERSION - Kind:
str - Signature/type:
str - Public exports:
pllm.providers.HOST_COMPONENT_STANDARD_VERSION
HOST_NATIVE_PLUGIN_ABI_VERSION
Provides the public version value used where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.HOST_NATIVE_PLUGIN_ABI_VERSION - Kind:
str - Signature/type:
str - Public exports:
pllm.providers.HOST_NATIVE_PLUGIN_ABI_VERSION
PROVIDER_ENTRY_POINT_GROUP
Provides the public group value used where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.PROVIDER_ENTRY_POINT_GROUP - Kind:
str - Signature/type:
str - Public exports:
pllm.providers.PROVIDER_ENTRY_POINT_GROUP
PROVIDER_MANIFEST_SCHEMA
Provides the public schema value used where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.PROVIDER_MANIFEST_SCHEMA - Kind:
str - Signature/type:
str - Public exports:
pllm.providers.PROVIDER_MANIFEST_SCHEMA
ProviderDescriptor
Immutable ProviderDescriptor record carrying provider, distribution, version, host_versions, category_versions, components, schemas, docs, native_artifacts, python_factories, tested_builds, entry_point, manifest_digest, editable, component_classes for the workflow where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.ProviderDescriptor - Kind:
class - Signature/type:
constructor not exposed - Public exports:
pllm.ProviderDescriptor,pllm.providers.ProviderDescriptor - Public members:
provider: str;distribution: str;version: str;host_versions: tuple[str, ...];category_versions: Mapping[str, tuple[str, ...]];components: tuple[ComponentDescriptor, ...];schemas: tuple[ProviderResource, ...];docs: tuple[ProviderResource, ...];native_artifacts: tuple[ProviderResource, ...];python_factories: Mapping[str, str];tested_builds: tuple[Mapping[str, Any], ...];entry_point: str;manifest_digest: str;editable: bool;component_classes: tuple[type[ComponentRef], ...];to_dict(self) -> dict[str, Any]
ProviderDiscoveryError
Raised when a ProviderDiscovery condition prevents the requested operation from completing.
- Canonical object:
pllm.providers.ProviderDiscoveryError - Kind:
class - Signature/type:
constructor not exposed - Public exports:
pllm.ProviderDiscoveryError,pllm.providers.ProviderDiscoveryError
ProviderResource
Immutable ProviderResource record carrying path, sha256, abi_version, targets for the workflow where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.ProviderResource - Kind:
class - Signature/type:
__init__(self, path: str, sha256: str, abi_version: str \| None=None, targets: tuple[str, ...]=()) -> None - Public exports:
pllm.ProviderResource,pllm.providers.ProviderResource - Public members:
path: str;sha256: str;abi_version: str \| None;targets: tuple[str, ...];__init__(self, path: str, sha256: str, abi_version: str \| None=None, targets: tuple[str, ...]=()) -> None;to_dict(self) -> dict[str, Any]
discover_providers
Discovers static provider manifests without importing provider implementation code.
- Canonical object:
pllm.providers.discover_providers - Kind:
function - Signature/type:
discover_providers(*, entry_points: Iterable[Any] \| None=None, allow_editable: bool=False, host_version: str=HOST_COMPONENT_STANDARD_VERSION) -> tuple[ProviderDescriptor, ...] - Public exports:
pllm.discover_providers,pllm.providers.discover_providers
load_component_factory
Performs the load component factory operation for the workflow where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.load_component_factory - Kind:
function - Signature/type:
load_component_factory(provider: ProviderDescriptor, component: str, *, approved_providers: Collection[str]) -> Any - Public exports:
pllm.load_component_factory,pllm.providers.load_component_factory
provider_component_classes
Performs the provider component classes operation for the workflow where provider discovery reads package-confined static manifests without importing provider code; factory loading is a separate approved operation.
- Canonical object:
pllm.providers.provider_component_classes - Kind:
function - Signature/type:
provider_component_classes(providers: Iterable[ProviderDescriptor]) -> tuple[type[ComponentRef], ...] - Public exports:
pllm.providers.provider_component_classes