# Naylence Runtime
> Message fabric, connectors, listeners, and security primitives that power Naylence agents, nodes and sentinels. This package provides the **runtime substrate**—not the high‑level Agent SDK or tutorials.
---
## What this is
**naylence‑runtime** is the foundational library that implements:
* **FAME fabric** (in‑process and networked) for routing envelopes between clients, agents, and sentinels.
* **Connectors & listeners** for WebSocket/HTTP transports, back‑pressure, flow control, and streaming.
* **Profiles & admission**: pluggable admission flows (e.g., token‑based), logical addressing, and attach APIs.
* **Security building blocks**: envelope signing, overlay encryption, JWT/JWKS helpers, and identity hooks.
* **FastAPI utilities** used by sentinels and auxiliary services (JWKS, OAuth token router, etc.).
It is meant to be **embedded** by the Agent SDK, sentinels, and security add‑ons. Most users should not call it directly unless they’re extending transports, writing custom admission, or integrating Naylence into an existing control plane.
---
## When to use (and when not)
Use **naylence‑runtime** if you need to:
* Build or customize **transport connectors/listeners**.
* Implement or extend **admission/identity** flows.
* Operate a bespoke **sentinel** or welcome/CA services.
Prefer the higher‑level packages for day‑to‑day development:
* **Naylence Agent SDK (Python)** — idiomatic agent APIs & ergonomics. → [https://github.com/naylence/naylence-agent-sdk-python](https://github.com/naylence/naylence-agent-sdk-python)
* **Naylence Examples (Python)** — runnable learning path & patterns. → [https://github.com/naylence/naylence-examples-python](https://github.com/naylence/naylence-examples-python)
If you’re just getting started, learn with the **Agent SDK** and **Examples** first; drop down to **Runtime** only when you need lower‑level control.
---
## Security profiles
The runtime exposes security primitives used by sentinels and agents through **profiles**:
* **direct** — no admission; useful for local/dev.
* **gated** — OAuth2/JWT‑gated admission; TLS via your reverse proxy.
* **strict‑overlay** — sealed, end‑to‑end overlay encryption with SPIFFE/X.509‑style identities.
> **Important:** The **strict‑overlay** profile is supported **only** when the **`naylence‑advanced‑security`** package is installed. Install that add‑on to enable sealed channels and SVID‑backed identities.
---
## Relationship to other repos
* **Runtime (this repo):** [https://github.com/naylence/naylence-runtime-python](https://github.com/naylence/naylence-runtime-python)
* **Agent SDK (Python):** [https://github.com/naylence/naylence-agent-sdk-python](https://github.com/naylence/naylence-agent-sdk-python)
* **Examples (Python):** [https://github.com/naylence/naylence-examples-python](https://github.com/naylence/naylence-examples-python)
* **Advanced Security add‑on:** [https://github.com/naylence/naylence-advanced-security-python](https://github.com/naylence/naylence-advanced-security-python)
---
## What this README intentionally omits
This page explains **purpose and scope** only. It does **not** include code samples, quick starts, or container recipes. For that:
* Start with the **Agent SDK** docs and examples to learn the development model.
* Refer to the **Examples** repository for runnable demos from simple to distributed to security‑hardened.
---
## Support & license
* **Issues:** open tickets in the corresponding repository (Runtime, SDK, Examples, or Advanced Security) based on where the problem belongs.
* **License:** Apache‑2.0.
Raw data
{
"_id": null,
"home_page": null,
"name": "naylence-runtime",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "messaging, ai, agents, platform, naylence",
"author": "naylencedev@gmail.com",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b3/27/4023435055ccb368149cfbde1aff6962562c037e4c3b5e0a933c589858a2/naylence_runtime-0.1.89.tar.gz",
"platform": null,
"description": "# Naylence Runtime\n\n> Message fabric, connectors, listeners, and security primitives that power Naylence agents, nodes and sentinels. This package provides the **runtime substrate**\u2014not the high\u2011level Agent SDK or tutorials.\n\n---\n\n## What this is\n\n**naylence\u2011runtime** is the foundational library that implements:\n\n* **FAME fabric** (in\u2011process and networked) for routing envelopes between clients, agents, and sentinels.\n* **Connectors & listeners** for WebSocket/HTTP transports, back\u2011pressure, flow control, and streaming.\n* **Profiles & admission**: pluggable admission flows (e.g., token\u2011based), logical addressing, and attach APIs.\n* **Security building blocks**: envelope signing, overlay encryption, JWT/JWKS helpers, and identity hooks.\n* **FastAPI utilities** used by sentinels and auxiliary services (JWKS, OAuth token router, etc.).\n\nIt is meant to be **embedded** by the Agent SDK, sentinels, and security add\u2011ons. Most users should not call it directly unless they\u2019re extending transports, writing custom admission, or integrating Naylence into an existing control plane.\n\n---\n\n## When to use (and when not)\n\nUse **naylence\u2011runtime** if you need to:\n\n* Build or customize **transport connectors/listeners**.\n* Implement or extend **admission/identity** flows.\n* Operate a bespoke **sentinel** or welcome/CA services.\n\nPrefer the higher\u2011level packages for day\u2011to\u2011day development:\n\n* **Naylence Agent SDK (Python)** \u2014 idiomatic agent APIs & ergonomics. \u2192 [https://github.com/naylence/naylence-agent-sdk-python](https://github.com/naylence/naylence-agent-sdk-python)\n* **Naylence Examples (Python)** \u2014 runnable learning path & patterns. \u2192 [https://github.com/naylence/naylence-examples-python](https://github.com/naylence/naylence-examples-python)\n\nIf you\u2019re just getting started, learn with the **Agent SDK** and **Examples** first; drop down to **Runtime** only when you need lower\u2011level control.\n\n---\n\n## Security profiles\n\nThe runtime exposes security primitives used by sentinels and agents through **profiles**:\n\n* **direct** \u2014 no admission; useful for local/dev.\n* **gated** \u2014 OAuth2/JWT\u2011gated admission; TLS via your reverse proxy.\n* **strict\u2011overlay** \u2014 sealed, end\u2011to\u2011end overlay encryption with SPIFFE/X.509\u2011style identities.\n\n> **Important:** The **strict\u2011overlay** profile is supported **only** when the **`naylence\u2011advanced\u2011security`** package is installed. Install that add\u2011on to enable sealed channels and SVID\u2011backed identities.\n\n---\n\n## Relationship to other repos\n\n* **Runtime (this repo):** [https://github.com/naylence/naylence-runtime-python](https://github.com/naylence/naylence-runtime-python)\n* **Agent SDK (Python):** [https://github.com/naylence/naylence-agent-sdk-python](https://github.com/naylence/naylence-agent-sdk-python)\n* **Examples (Python):** [https://github.com/naylence/naylence-examples-python](https://github.com/naylence/naylence-examples-python)\n* **Advanced Security add\u2011on:** [https://github.com/naylence/naylence-advanced-security-python](https://github.com/naylence/naylence-advanced-security-python)\n\n---\n\n## What this README intentionally omits\n\nThis page explains **purpose and scope** only. It does **not** include code samples, quick starts, or container recipes. For that:\n\n* Start with the **Agent SDK** docs and examples to learn the development model.\n* Refer to the **Examples** repository for runnable demos from simple to distributed to security\u2011hardened.\n\n---\n\n## Support & license\n\n* **Issues:** open tickets in the corresponding repository (Runtime, SDK, Examples, or Advanced Security) based on where the problem belongs.\n* **License:** Apache\u20112.0.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Naylence Runtime",
"version": "0.1.89",
"project_urls": {
"Bug Tracker": "https://github.com/naylence/naylence-runtime-python/issues",
"Documentation": "https://github.com/naylence/naylence-runtime-python#readme",
"Homepage": "https://github.com/naylence/naylence-runtime-python",
"Repository": "https://github.com/naylence/naylence-runtime-python"
},
"split_keywords": [
"messaging",
" ai",
" agents",
" platform",
" naylence"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a5c0bc8907e14d824948ebca905ad1a1408b7ca78ba8107675011325977fc8c9",
"md5": "d71d6163e7feb7a06a2973e5894ac235",
"sha256": "bab5486ee52270b85da458322c811905db1233a548fa0c05b67c82f12dafb83d"
},
"downloads": -1,
"filename": "naylence_runtime-0.1.89-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d71d6163e7feb7a06a2973e5894ac235",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 416918,
"upload_time": "2025-09-05T00:31:30",
"upload_time_iso_8601": "2025-09-05T00:31:30.892190Z",
"url": "https://files.pythonhosted.org/packages/a5/c0/bc8907e14d824948ebca905ad1a1408b7ca78ba8107675011325977fc8c9/naylence_runtime-0.1.89-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b3274023435055ccb368149cfbde1aff6962562c037e4c3b5e0a933c589858a2",
"md5": "3ff642e118dd23cf3a869acd9ef11dc0",
"sha256": "c350fd357e5d52592803b63a0482dc5d67684715b249f599222bef82c70bcc84"
},
"downloads": -1,
"filename": "naylence_runtime-0.1.89.tar.gz",
"has_sig": false,
"md5_digest": "3ff642e118dd23cf3a869acd9ef11dc0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 272585,
"upload_time": "2025-09-05T00:31:32",
"upload_time_iso_8601": "2025-09-05T00:31:32.630582Z",
"url": "https://files.pythonhosted.org/packages/b3/27/4023435055ccb368149cfbde1aff6962562c037e4c3b5e0a933c589858a2/naylence_runtime-0.1.89.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-05 00:31:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "naylence",
"github_project": "naylence-runtime-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "naylence-runtime"
}
JSON
