Skip to main content
Pre-release

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

tigrbl-runtime

Tigrbl logo

Execution bridge for compiled Tigrbl kernel plans and narrow runtime context/carrier compatibility.

PyPI version for tigrbl-runtime Downloads for tigrbl-runtime Discord community for tigrbl-runtime Repository hits for tigrbl-runtime README Apache 2.0 license Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-runtime Workspace group for tigrbl-runtime

What is tigrbl-runtime?

tigrbl-runtime executes compiled Tigrbl kernel plans and preserves the narrow runtime context/carrier bridge needed to run those plans. Route selection, protocol fallback policy, response shaping, transport envelopes, and operation semantics are owned by kernel, atoms, and ops packages.

Why use tigrbl-runtime?

Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.

When should I install tigrbl-runtime?

Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.

Who is tigrbl-runtime for?

Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.

Where does tigrbl-runtime fit?

tigrbl-runtime lives at pkgs/50_runtime/tigrbl_runtime and serves a focused layer in the split Tigrbl framework.

How does tigrbl-runtime work?

It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.

Install

uv add tigrbl-runtime
pip install tigrbl-runtime

Surface Coverage

Surface Value
PyPI package tigrbl-runtime
Repository path pkgs/50_runtime/tigrbl_runtime
Python import root tigrbl_runtime
Console scripts none declared
Entry points none declared
Optional extras none declared
Legal files LICENSE, NOTICE
Supported Python `3.10

What It Owns

tigrbl-runtime owns the compiled-plan execution boundary. It should be installed when you need the narrow bridge that runs already-planned Tigrbl work without assuming the full facade is present.

Implementation orientation:

  • tigrbl_runtime: compiled plan execution, runtime context compatibility, and declared carrier lifecycle bridges

Runtime authoring BCP:

  • Do use this package for executing compiled kernel plans and maintaining runtime context/carrier compatibility.
  • Do keep execution aligned with compiled plans.
  • Do not add route matching semantics, protocol fallback policy, JSON-RPC/REST envelope policy, response rendering, chunk emission semantics, operation behavior, or new executor families.
  • Do not make application route handlers, FastAPI/Starlette objects, direct SQLAlchemy session calls, or ad-hoc engine construction the runtime contract.
  • Do not bypass kernel plans or lifecycle phases when adding REST, JSON-RPC, stream, SSE, WebSocket, or WebTransport behavior.
  • Avoid hiding behavior in runtime wrappers that diagnostics and compiled plans cannot inspect.

Public API and Import Surface

Usage Examples

Verify the installed package

python -m pip show tigrbl-runtime
python - <<'PY'
from importlib.metadata import version
print(version("tigrbl-runtime"))
PY

Import the package boundary

import importlib

module = importlib.import_module("tigrbl_runtime")
print(module.__name__)

Import a public symbol

from tigrbl_runtime import Runtime

print(Runtime)

Use with the facade when building applications

uv add tigrbl tigrbl-runtime
python - <<'PY'
import tigrbl
print(tigrbl.__name__)
PY

How To Choose This Package

Choose tigrbl-runtime when the quick-answer table matches your use case. Choose tigrbl instead when you want the full public facade. Choose a lower-level package such as tigrbl-core, tigrbl-base, or tigrbl-runtime when you are building framework extensions or testing a specific internal boundary.

Support

Package-local Boundary

This README is the package-local distribution entry point for tigrbl-runtime. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.

Certification Status

  • Package status: governed package in the tigrbl/tigrbl workspace.
  • Governance source: SSOT registry.
  • Release evidence: publish workflow validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
  • Local certification guard: pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, LICENSE, and NOTICE.
  • Scope note: this README documents the package boundary. Runtime feature support remains governed by .ssot/ entities and the conformance docs linked below.

License

Licensed under the Apache License, Version 2.0. See LICENSE, NOTICE, and the official Apache 2.0 license text.

Lowering integration

lowering_services lazily exposes canonical kernel operation-view compilation and WebSocket JSON-RPC session construction to concrete integration code. It preserves the kernel function objects and keeps kernel imports out of concrete authoring modules.

Metadata

Release files for tigrbl-runtime 0.4.5.dev6

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

Source distribution (sdist)

Source distribution for tigrbl-runtime 0.4.5.dev6
File Size Uploaded Provenance Actions
tigrbl_runtime-0.4.5.dev6.tar.gz 65.6 kB Without provenance Details for tigrbl_runtime-0.4.5.dev6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tigrbl-runtime 0.4.5.dev6
File Interpreter ABI Platform Actions
tigrbl_runtime-0.4.5.dev6-py3-none-any.whl Python 3 none any Details for tigrbl_runtime-0.4.5.dev6-py3-none-any.whl

Total release size: 154.2 kB

Release files / tigrbl_runtime-0.4.5.dev6.tar.gz

Download URL tigrbl_runtime-0.4.5.dev6.tar.gz
Size 65.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b19ae280dcf0969538281ffeb047bc0ea5a9f027b77835b4ce1e772c9ee39115
BLAKE2b-256 checksum
How to use checksums
d519bb5159e7f6baf58254fd601b4ff0f941713410e3d087f7baec1c9f6fa8c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / tigrbl_runtime-0.4.5.dev6-py3-none-any.whl

Download URL tigrbl_runtime-0.4.5.dev6-py3-none-any.whl
Size 88.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2d1c6d516a2db28b40e6e25262c5805c6cb066407b8faf35edc1abd76098082
BLAKE2b-256 checksum
How to use checksums
e3655937ebc0e6048ab1a28a6e3fc6572f8994961aed52bcf6348db5d0abede9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for tigrbl-runtime 0.4.5.dev6

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