Registry / omnibase-spi

omnibase-spi

library0.22.0pypypi✓ verified 80d ago

ONEX Service Provider Interface – Protocol definitions for building service providers in the OmniNode ecosystem. Version 0.20.5 requires Python >=3.12. Active development with frequent releases (weekly/monthly).

pip install omnibase-spi

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · OMNIBASE-SPI

omnibase-spi

pythonv0.22.0

Install

9.3s avg

Import

—

Disk

134MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.22.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✕ build_error

py 3.12

✓ —

✓ 9.2s

py 3.13

✓ —

✓ 9.5s

py 3.9

✕ build_error

134MB installed

● package 134MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ProtocolArtifactContainer

✓ from omnibase_spi import ProtocolArtifactContainer

✗ from omnibase_spi.models import ContractSavingsEstimate

ProtocolCacheService

✓ from omnibase_spi import ProtocolCacheService

ProtocolEffect

✓ from omnibase_spi import ProtocolEffect

Basic usage: create a model instance and dump JSON.

from omnibase_spi.models import ContractSavingsEstimate estimate = ContractSavingsEstimate( contract_id="123", estimated_savings=1000.0, currency="USD" ) print(estimate.model_dump_json(indent=2))

Debug

Known issues

breakingPython >=3.12 only: omnibase_spi uses new syntax features not available in older versions.

fix

Upgrade to Python 3.12+ or use an older version if unavoidable.

affects: 0.18.0+

deprecatedThe env-prefix mandate from older SPI protocol contracts was removed in v0.18.0. Do not rely on environment variable prefix constraints.

fix

Remove any code that expects a mandatory prefix (e.g., 'ONEX_').

affects: >=0.18.0

gotchaProtocol classes are defined in separate submodules (e.g., omnibase_spi.protocols, omnibase_spi.models). Importing from the top-level package may not work.

fix

Always use explicit submodule imports (e.g., from omnibase_spi.protocols import ...).

affects: all

Upgrade

Version history

0.22.0latest on PyPI · released May 26, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/OmniNode-ai/omnibase_spi ↗

packagehttps://pypi.org/project/omnibase-spi/ ↗

docshttps://github.com/OmniNode-ai/omnibase_spi/tree/main/docs ↗